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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

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.

Make sure that billing is enabled for your Google Cloud project.

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.

Enable the Cloud Translation API.

Enable the 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.

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 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 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.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

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

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

If you are using Gradle, add the following to your dependencies:

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

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

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

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

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

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

If you are using Gradle, add the following to your dependencies:

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

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

Hinweis: Sie können diesen Schritt überspringen, wenn Sie nicht die Befehlszeile 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 folgendem Link:

Install the Google Cloud CLI, then initialize it by running the following command:

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

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

  • Kurzanleitung zu Cloud Translation
  • Cloud Translation Advanced-Kurzanleitung

• Anleitungen 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