Von Basic zu Advanced migrieren

Vorhandene Nutzer von Cloud Translation Basic (v2), die die neuesten Translation-Funktionen wie Glossare und AutoML-Modelle verwenden möchten, müssen ihre Anwendungen zur Verwendung von Cloud Translation Advanced (v3) migrieren. Einen Vergleich finden Sie unter Einfach und Erweitert.

Die Migration zur Advanced-Version umfasst Identity and Access Management (IAM) und die Advanced Edition-Clientbibliotheken. In den folgenden Abschnitten werden Migrationsaufgaben und die Hauptunterschiede zwischen den beiden Versionen beschrieben.

Zur erweiterten Version migrieren

In den folgenden Schritten werden die Maßnahmen beschrieben, die Sie benötigen, um Ihre vorhandenen Anwendungen von Cloud Translation Basic bis Cloud Translation Advanced zu aktualisieren.

  1. Stellen Sie Ihre Google Cloud-Projekte, -Anwendungen und -Nutzer fest, die auf die Cloud Translation Basic API zugreifen. Sie müssen Dienstkonten bereitstellen und für die Verwendung der Cloud Translation Advanced-Clientbibliotheken aktualisieren.
  2. Richten Sie Dienstkonten und die Authentifizierung für Ihre Anwendung ein.
  3. Verwenden Sie IAM-Rollen, um Berechtigungen für Dienstkonten festzulegen.
  4. Aktivieren Sie Cloud Translation Advanced für Ihr Projekt. Wenn Sie AutoML-Modelle mit Cloud Translation Advanced verwenden, müssen Sie auch AutoML aktivieren. Weitere Informationen finden Sie im Leitfaden für die Einrichtung.
  5. Verwenden Sie die Clientbibliotheken und -methoden von Cloud Translation Advanced. Bei Cloud Translation Advanced-Anfragen müssen Sie die Projektnummer oder Projekt-ID und den Projektstandort wie global oder us-central1 angeben.
  6. Überprüfen Sie, ob die Größe Ihrer Übersetzungsanfragen an Cloud Translation – Advanced das Limit nicht überschreitet.
  7. Planen Sie das Monitoring Ihres Kontingents für Übersetzungsanfragen. Beide Versionen der API haben dieselben täglichen und monatlichen Kontingente.
  8. Prüfen Sie die Abrechnung auf mögliche Änderungen.

Hauptunterschiede zwischen Advanced und Basic

Damit Sie Ihre Migrationsaufgaben besser verstehen, wird in den folgenden Abschnitten die wichtigsten Unterschiede zwischen der erweiterten und der Basic-Version erläutert.

Dienstkonten

Für Cloud Translation Basic können Sie authentifizierte Anfragen mithilfe von API-Schlüsseln oder Dienstkonten senden.

Cloud Translation Advanced enthält Features, für die vom Kunden verwaltete Ressourcen benötigt werden. Für diese Ressourcen ist die Verwaltung von IAM-Rollen und Berechtigungen erforderlich. Daher können Sie keine API-Schlüssel zur Authentifizierung beim Service verwenden. Stattdessen müssen Sie Dienstkonten für die Authentifizierung bei Cloud Translation Advanced verwenden.

Weitere Informationen finden Sie im Leitfaden für die Einrichtung.

IAM-Rollen

Wenn Sie Dienstkonten für Cloud Translation Basic verwenden, werden die Dienstkonten nur zur Authentifizierung verwendet. Sie können Aufrufe an Cloud Translation Basic senden, unabhängig davon, welche Berechtigungen mit dem Dienstkonto verknüpft sind. Für Cloud Translation Advanced gelten die Berechtigungen.

Wenn Sie Dienstkonten Berechtigungen zum Aufrufen von Cloud Translation Advanced erteilen möchten, weisen Sie ihnen IAM-Rollen zu. Cloud Translation Advanced bietet verschiedene IAM-Rollen, die Sie Ihrem Dienstkonto für den Zugriff auf bestimmte Ressourcen im Projekt zuweisen können. Wenn Sie beispielsweise Ihr Dienstkonto zum Übersetzen von Text verwenden möchten, weisen Sie ihm die Rolle roles/cloudtranslate.user zu. Weitere Informationen finden Sie unter "IAM-Rollen" unter Cloud Translation Advanced-Details.

Wenn Sie AutoML-Modelle oder Features verwenden möchten, die auf Cloud Storage basieren, müssen Sie auch die entsprechenden Rollen für diese Dienste angeben. Eine Liste aller IAM-Rollen finden Sie in der Dokumentation zu IAM-Rollen.

Übersetzungsmodelle

Wenn Sie eine Anfrage für eine Übersetzung an Cloud Translation Basic senden, können Sie eines von zwei allgemeinen Modellen verwenden: Neural Machine Translation (NMT) oder Phrase-Based Machine Translation (PBMT). Für Cloud Translation Advanced können Sie die allgemeinen Modelle oder ein benutzerdefiniertes AutoML Translation-Modell verwenden.

Dienstkonten, die Sie für Übersetzungsanfragen verwenden, müssen die Berechtigungen für den Zugriff auf AutoML und allgemeine Modelle haben, die sich in verschiedenen Projekten befinden können. Nehmen wir z. B. an, Sie haben ein zentrales Projekt mit Ihren Übersetzungsmodellen, um die Wartung und Abrechnung zu vereinfachen. Dienstkonten in diesem Projekt oder anderen Projekten können diese Modelle verwenden, aber dafür sind Berechtigungen erforderlich.

Weitere Informationen zu Übersetzungsmodellen finden Sie unter Text übersetzen (Advanced).

Clientbibliotheken

Die Clientbibliotheken und Methoden für Cloud Translation Advanced unterscheiden sich von Cloud Translation Basic. Für Aufrufe von Cloud Translation Advanced sind beispielsweise Ressourcennamen erforderlich. Weitere Informationen finden Sie in der Übersicht zu Cloud Translation Advanced-Clientbibliotheken oder in der Kurzanleitung zur Übersetzung (Advanced Edition).

Ressourcen, Projekte und Standorte

Anfragen an Cloud Translation Advanced erfordern den Namen der Ressource, die Sie verwenden möchten. Eine Ressource ist in der Regel ein qualifizierter Name, der den Namen des Projekts und seinen Standort enthält, der angibt, wo die Anfrage ausgeführt wird. Beispielsweise ist der Name eines AutoML-Modells ein Ressourcenname.

Wenn Ihr Google Cloud-Projekt den Namen my-project hat und der Standort für die Ressource us-central1 lautet, könnte der vollständige Name Ihrer Ressourcen so aussehen:

projects/MY_PROJECT/locations/us-central1/...

Die URL, die Sie an die Anfrage getSupportedLanguages senden, sieht in etwa so aus:

https://translation.googleapis.com/v3/projects/my-project/locations/us-central1/supportedLanguages

Limit für Inhalte pro Anfrage

Die Cloud Translation API ist für die Übersetzung kleinerer Anfragen optimiert. Die empfohlene Maximallänge einer Anfrage beträgt 5.000 Zeichen (Codepunkte). Generell gilt aber: Je mehr Zeichen die Anfrage enthält, desto höher ist die Antwortlatenz. Bei Cloud Translation Advanced kann eine einzelne Anfrage maximal 30.000 Codepunkte haben. Cloud Translation Basic hat eine maximale Anfragengröße von 100.000 Byte.

Anfragen, die das Maximum überschreiten, werden von der Cloud Translation API mit der Fehlermeldung 400 INVALID_ARGUMENT abgelehnt, auch wenn noch ein freies Kontingent verfügbar ist.

Weitere Informationen zu Kontingenten und Limits finden Sie unter Kontingente.

Nächste Schritte

Mit Cloud Translation Advanced können Sie Text übersetzen, Glossare erstellen oder Batchanfragen erstellen.