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, bevor Sie den ersten Aufruf der Cloud Translation API ausführen.

Der Einrichtungsprozess umfasst die Google Cloud Console, eine Weboberfläche, mit der Sie Systeme in Google Cloud bereitstellen, 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.

Vorbereitung

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

Projekt erstellen oder auswählen

Wenn Sie Dienste von Google Cloud nutzen möchten, müssen Sie ein Projekt erstellen. Es dient zur Organisation all Ihrer Google Cloud-Ressourcen. Ein Projekt umfasst Mitarbeiter, aktivierte APIs (und andere Ressourcen), Monitoring-Tools, 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 der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

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.

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.

Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

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.

Cloud Translation API aktivieren.

Aktivieren Sie die API

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, sollten Sie Ihre tägliche Nutzung überwachen und die Kontingente an Ihre geplanten Ausgaben anpassen.

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, erfordert Google Cloud, dass das Hauptkonto die entsprechenden Berechtigungen hat. Sie können Berechtigungen gewähren, indem Sie einem Hauptkonto Rollen zuweisen. Weitere Informationen finden Sie unter Zugriff mit IAM steuern.

Clientbibliotheken installieren

Clientbibliotheken sind für mehrere 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 nicht Ihren Anforderungen entspricht oder in Ihrer Sprache nicht verfügbar ist, erstellen Sie einen eigenen benutzerdefinierten Code. 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

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.34.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

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

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

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

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

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

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

Node.js

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

npm install --save @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

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.34.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

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

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

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

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

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

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

Node.js

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

npm install --save @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

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 folgendem Link:

Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:

gcloud init

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 prüfen Sie, ob 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

Jetzt testen

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