Einrichtung

Damit Sie Cloud Translation verwenden können, benötigen Sie ein Projekt, für das die Cloud Translation API aktiviert ist, sowie die Anmeldedaten für authentifizierte Aufrufe. In den folgenden Abschnitten wird die Einrichtung beschrieben, die Sie ausführen müssen, bevor Sie den ersten Aufruf in der Cloud Translation API ausführen.

Der Einrichtungsprozess umfasst die Google Cloud Console, eine Weboberfläche, mit der Sie Systeme inGoogle Cloudbereitstellen, konfigurieren, verwalten und überwachen können. Wenn Sie die Google Cloud Console noch nicht verwendet haben, finden Sie weitere Informationen auf der Seite Cloud Console.

Hinweis

Cloud Translation ist in zwei Versionen (Basic und Advanced) verfügbar. Entscheiden Sie, welche davon verwendet werden soll, da jede Version eigene Clientbibliotheken hat.

Projekt erstellen oder auswählen

Wenn Sie Dienste von Google Cloudnutzen möchten, müssen Sie ein Projekt erstellen. In Projekten können Sie alle Ihre Google Cloud -Ressourcen organisieren. Ein Projekt umfasst Mitbearbeiter, aktivierte APIs (und andere Ressourcen), Monitoringtools, Zahlungsinformationen sowie Authentifizierungs- und Zugriffssteuerungen. Sie können wahlweise ein Projekt erstellen oder Ihre Google Cloud -Ressourcen durch Erstellen mehrerer Projekte in einer Ressourcenhierarchie organisieren. Notieren Sie sich beim Erstellen eines Projekts die Projekt-ID. Diese ID benötigen Sie für API-Aufrufe. Weitere Informationen zu Projekten finden Sie in der Dokumentation zu Resource Manager.

Wir empfehlen Ihnen, zum Experimentieren, zum Testen und für die Produktion separate Projekte zu erstellen. Notieren Sie nach dem Erstellen eines Projekts die Projektnummer oder ID. Sie müssen die Projektnummer (oder ID) angeben, wenn Sie Aufrufe an die Cloud Translation API senden.

Wählen Sie in der Google Cloud Console auf der Seite für die Projektauswahl ein Google Cloud -Projekt aus oder erstellen Sie eines.

Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen

Zur Projektauswahl

Abrechnung aktivieren

Sie müssen die Abrechnung aktivieren, um Cloud Translation verwenden zu können. Weitere Informationen zu den Preisen für Cloud Translation finden Sie in der Preisübersicht.

Hinweis: Zum Verwalten Ihres Budgets können Sie Ihre Nutzungslimits für Ihre Projekte festlegen. Weitere Informationen finden Sie unter Nutzungskontingente festlegen.

In Rechnungskonten ist festgelegt, wer die Nutzungsgebühren für Ressourcen bezahlt. Ein Rechnungskonto kann mit einem oder mehreren Projekten verknüpft sein. Die Gebühren für die Projektnutzung werden dem verknüpften Rechnungskonto belastet. In den meisten Fällen konfigurieren Sie die Abrechnung beim Erstellen eines Projekts. Weitere Informationen finden Sie in der Dokumentation zur Abrechnung.

Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

API aktivieren

Sie müssen die Cloud Translation API für Ihr Projekt aktivieren. Weitere Informationen zur Aktivierung von APIs finden Sie in der Dokumentation zu Service Usage.

Aktivieren Sie die Cloud Translation API.

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen

API aktivieren

Nutzungskontingente festlegen

Cloud Translation verfügt über ein Kontingentverwaltungssystem, mit dem Sie und Google die Nutzung des Dienstes verwalten können. Standardmäßig ist die Anzahl der Zeichen, die Sie pro Tag senden können, unbegrenzt. Wenn Sie ein festgelegtes Budget haben, empfehlen wir, Ihre tägliche Nutzung zu überwachen und die Kontingente entsprechend Ihren geplanten Ausgaben anzupassen.

Weitere Informationen zu Kontingenten finden Sie unter Kontingente und Limits.

Authentifizierung einrichten

Wenn Sie die Cloud Translation API verwenden möchten, müssen Sie die Authentifizierung einrichten. Jede Clientanwendung, die die API verwendet, muss authentifiziert sein und Zugriff auf die angeforderten Ressourcen haben. Weitere Informationen finden Sie unter Bei Cloud Translation authentifizieren.

Identitäts- und Zugriffsverwaltungsrollen

Wenn ein Hauptkonto (Nutzerkonto, Dienstkonto usw.) eine API aufruft, muss das Hauptkonto inGoogle Cloud die entsprechenden Berechtigungen haben. Sie können Berechtigungen gewähren, indem Sie einem Hauptkonto Rollen zuweisen. Weitere Informationen finden Sie unter Zugriff mit IAM steuern.

Hinweis: Rollenberechtigungen gelten nur für Cloud Translation Advanced. Sie können Dienstkonten für beide Versionen verwenden, aber nur bestimmte Berechtigungen für Cloud Translation Advanced. Für Cloud Translation Basic können Sie unabhängig von den Berechtigungen des Dienstkontos jede Anfrage stellen.

Clientbibliotheken installieren

Clientbibliotheken sind für verschiedene gängige Sprachen verfügbar. Wir empfehlen, diese Clientbibliotheken für Aufrufe an Cloud Translation zu verwenden, da sie den Zugriff auf die APIs erleichtern. Wenn eine Clientbibliothek Ihre Anforderungen nicht erfüllt oder nicht für Ihre Sprache verfügbar ist, können Sie eigenen Code erstellen. Weitere Informationen finden Sie unter Eigenen Clientcode verwenden.

Wenn Sie beispielsweise eine Clientbibliothek verwenden, können Ihre Anmeldedaten implizit über die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS bestimmt werden. Sie müssen Ihre Anmeldedaten nicht explizit im Code angeben. Weitere Informationen finden Sie in der Cloud APIs-Dokumentation unter Erläuterungen zu Clientbibliotheken.

Cloud Translation Basic-Clientbibliotheken

Wählen Sie die Programmiersprache aus, die Sie für die Entwicklung verwenden, und führen Sie dann den entsprechenden Befehl aus. Weitere Informationen finden Sie in der Übersicht zu Clientbibliotheken.

C#

nuget install Google.Cloud.Translation.V2

Go

go get cloud.google.com/go/translate

Java

Vorsicht:Android wird von der Java-Clientbibliothek nicht unterstützt.

Wenn Sie Maven verwenden, fügen Sie Ihrer Datei pom.xml den folgenden Code hinzu. Weitere Informationen zu BOMs finden Sie unter The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.78.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

Wenn Sie Gradle verwenden, fügen Sie den Abhängigkeiten Folgendes hinzu:

implementation 'com.google.cloud:google-cloud-translate:2.87.0'

Wenn Sie sbt nutzen, fügen Sie den Abhängigkeiten Folgendes hinzu:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.87.0"

Wenn Sie Visual Studio Code oder IntelliJ verwenden, können Sie Ihrem Projekt mithilfe der folgenden IDE-Plug-ins Clientbibliotheken hinzufügen:

• Cloud Code für VS Code
• Cloud Code for IntelliJ

Diese Plug-ins bieten zusätzliche Funktionen wie die Schlüsselverwaltung für Dienstkonten. Einzelheiten finden Sie in der Dokumentation der einzelnen Plug-ins.

Hinweis: Cloud-Java-Clientbibliotheken unterstützen derzeit Android nicht.

Node.js

Weitere Informationen zur Einrichtung der Node.js-Entwicklungsumgebung finden Sie im Einrichtungsleitfaden für die Node.js-Entwicklungsumgebung.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Weitere Informationen zur Einrichtung der Python-Entwicklungsumgebung finden Sie im Einrichtungsleitfaden für die Python-Entwicklungsumgebung.

pip install google-cloud-translate==2.0.1

Ruby

Weitere Informationen zur Einrichtung der Ruby-Entwicklungsumgebung finden Sie im Einrichtungsleitfaden für die Ruby-Entwicklungsumgebung.

gem install google-cloud-translate-v2

Cloud Translation Advanced-Clientbibliotheken

Wählen Sie die Programmiersprache aus, die Sie für die Entwicklung verwenden, und führen Sie dann den entsprechenden Befehl aus. Weitere Informationen finden Sie in der Übersicht zu Clientbibliotheken für Cloud Translation Advanced.

C#

nuget install Google.Cloud.Translate.V3 -Pre

Go

go get cloud.google.com/go/translate/apiv3

Java

Vorsicht:Android wird von der Java-Clientbibliothek nicht unterstützt.

Wenn Sie Maven verwenden, fügen Sie Ihrer Datei pom.xml den folgenden Code hinzu. Weitere Informationen zu BOMs finden Sie unter The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.78.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

Wenn Sie Gradle verwenden, fügen Sie den Abhängigkeiten Folgendes hinzu:

implementation 'com.google.cloud:google-cloud-translate:2.87.0'

Wenn Sie sbt nutzen, fügen Sie den Abhängigkeiten Folgendes hinzu:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.87.0"

Wenn Sie Visual Studio Code oder IntelliJ verwenden, können Sie Ihrem Projekt mithilfe der folgenden IDE-Plug-ins Clientbibliotheken hinzufügen:

• Cloud Code für VS Code
• Cloud Code for IntelliJ

Diese Plug-ins bieten zusätzliche Funktionen wie die Schlüsselverwaltung für Dienstkonten. Einzelheiten finden Sie in der Dokumentation der einzelnen Plug-ins.

Hinweis: Cloud-Java-Clientbibliotheken unterstützen derzeit Android nicht.

Node.js

Weitere Informationen zur Einrichtung der Node.js-Entwicklungsumgebung finden Sie im Einrichtungsleitfaden für die Node.js-Entwicklungsumgebung.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Weitere Informationen zur Einrichtung der Python-Entwicklungsumgebung finden Sie im Einrichtungsleitfaden für die Python-Entwicklungsumgebung.

pip install --upgrade google-cloud-translate

Ruby

Weitere Informationen zur Einrichtung der Ruby-Entwicklungsumgebung finden Sie im Einrichtungsleitfaden für die Ruby-Entwicklungsumgebung.

gem install google-cloud-translate

Google Cloud CLI installieren

Hinweis: Sie können diesen Schritt überspringen, wenn Sie die Befehlszeile nicht für authentifizierte API-Aufrufe verwenden.

Wenn Sie Cloud Translation-Anfragen über die Befehlszeile senden möchten (z. B. über curl-Befehle), installieren und initialisieren Sie die gcloud CLI, die im Google Cloud CLI enthalten ist. Weitere Informationen finden Sie unter dem folgenden Link:

Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:

gcloud init

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

SDK und Authentifizierung testen

Wenn Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS eingerichtet haben, können Sie Ihre Authentifizierungsumgebung mit gcloud testen. Führen Sie den folgenden Befehl aus und achten Sie darauf, dass kein Fehler auftritt und Anmeldedaten zurückgegeben werden:

gcloud auth application-default print-access-token

Der vorherige Befehl wird in allen REST-Beispielen für die Cloud Translation-Befehlszeile verwendet, um API-Aufrufe zu authentifizieren.

Nächste Schritte

• Probieren Sie die Kurzanleitungen aus, um einfache Übersetzungsaufrufe zu senden:

  • Kurzanleitung zu Cloud Translation Basic
  • Kurzanleitung zu Cloud Translation Advanced

• Produktübersicht zur Verwendung verschiedener Cloud Translation-Features

Überzeugen Sie sich selbst

Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit von Cloud Translation in der Praxis prüfen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Cloud Translation kostenlos testen