Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

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.

Cloud Translation ist in zwei Versionen verfügbar. Entscheiden Sie zuerst, welche Version Sie verwenden werden, da die Installationen der Clientbibliotheken unterschiedlich sind.

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.

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 Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt 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.

Aktivieren Sie die API

Authentifizierung einrichten

Wenn Sie die Cloud Translation API verwenden möchten, müssen Sie die Authentifizierung einrichten. Jede Client-Anwendung, die die API verwendet, muss authentifiziert sein und Zugriff auf die angeforderten Ressourcen haben. In diesem Abschnitt werden wichtige Konzepte der Authentifizierung erklärt und Schritte für die Einrichtung beschrieben. Weitere Informationen finden Sie in der Authentifizierungsübersicht für Google Cloud.

Dienstkonto und privater Schlüssel

Für die Authentifizierung gibt es mehrere Möglichkeiten. Es wird jedoch empfohlen, für die Authentifizierung und die Zugriffssteuerung Dienstkonten zu verwenden. Die Anmeldedaten für ein Dienstkonto werden für Anwendungen vergeben, nicht für Endnutzer. Dienstkonten gehören zu Projekten. Sie können mehrere Dienstkonten für ein Projekt erstellen. Weitere Informationen finden Sie unter Details zu Dienstkonten.

Dienstkonten sind mit einem oder mehreren öffentlichen/privaten Schlüsselpaaren verbunden. Wenn Sie ein neues Schlüsselpaar erstellen, laden Sie den privaten Schlüssel herunter. Der private Schlüssel wird verwendet, um beim Aufrufen der API Anmeldedaten zu erzeugen. Die Verantwortung für die Sicherheit des privaten Schlüssels und andere Verwaltungsvorgänge wie die Schlüsselrotation liegt bei Ihnen.

Identitäts- und Zugriffsverwaltungsrollen

Wenn eine Identität eine API aufruft, wird von Google Cloud verlangt, dass die Identität über die entsprechenden Berechtigungen verfügt. Sie können Berechtigungen gewähren durch Zuweisen von Rollen für Dienstkonten. Weitere Informationen finden Sie in der Dokumentation zur Identitäts- und Zugriffsverwaltung (IAM).

Dienstkonten und Schlüssel erstellen

Authentifizierung einrichten:

  1. Wechseln Sie in der Cloud Console zur Seite Dienstkontoschlüssel erstellen.

    Zur Seite „Dienstkontoschlüssel erstellen“
  2. Wählen Sie aus der Liste Dienstkonto die Option Neues Dienstkonto aus.
  3. Geben Sie im Feld Dienstkontoname einen Namen ein.
  4. Wählen Sie in der Liste Rolle die Option Projekt > Inhaber

  5. Klicken Sie auf Erstellen. Eine JSON-Datei mit Ihrem Schlüssel wird auf Ihren Computer heruntergeladen.

Weitere Informationen zu den verschiedenen Rollen finden Sie unter Rollen von Cloud Translation Advanced. Wenn Sie beispielsweise Ihrem Dienstkonto die Übersetzung von Text erlauben möchten, weisen Sie ihm die Rolle roles/cloudtranslate.user zu. Alle mit diesem Dienstkonto verknüpften Schlüssel erhalten die gleichen Berechtigungen.

Schlüsseldatei des Dienstkontos in Ihrer Umgebung verwenden

Die Anmeldedaten zur Authentifizierung für Ihren Anwendungscode geben Sie durch Festlegung der Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS an. Geben Sie für [PATH] den Dateipfad der JSON-Datei an, die Ihren Dienstkontoschlüssel enthält. Diese Variable gilt nur für Ihre aktuelle Shell-Sitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable neu festlegen.

Linux oder macOS

export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Beispiel:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"

Windows

Mit PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Beispiel:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"

Mit Eingabeaufforderung:

set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

Alternativ können Sie auf die JSON-Datei in Ihrem Code verweisen. Weitere Informationen finden Sie unter Anmeldedaten mit Code übergeben.

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 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 -u 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>18.0.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 platform('com.google.cloud:libraries-bom:16.4.0')

compile 'com.google.cloud:google-cloud-translate'

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

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

Bei Verwendung von IntelliJ oder Eclipse 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

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 -u 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>18.0.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 platform('com.google.cloud:libraries-bom:16.4.0')

compile 'com.google.cloud:google-cloud-translate'

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

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

Bei Verwendung von IntelliJ oder Eclipse 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

Cloud SDK installieren

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

Installieren und initialisieren Sie das Cloud SDK.

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 ein Konto, um zu beurteilen, wie Cloud Translation in realen Szenarien abschneidet. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Cloud Translation kostenlos testen