Von Basic zu Advanced migrieren

Bestehende Nutzer von Cloud Translation Basic (v2), die die neuesten Cloud Translation-Features wie Glossare und AutoML-Modelle verwenden möchten, müssen ihre Anwendungen zu Cloud Translation Advanced (v3) migrieren. Einen Vergleich finden Sie unter Basis- und Advanced-Version vergleichen.

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

Zur erweiterten Version migrieren

In folgenden Schritten werden die Aktionen beschrieben, die zur Aktualisierung Ihrer vorhandenen Anwendungen von Cloud Translation Basic auf Cloud Translation Advanced erforderlich sind.

1. Ermitteln Sie Ihre Google Cloud-Projekte, -Anwendungen und -Nutzer, die auf die Cloud Translation Basic API zugreifen. Sie müssen Dienstkonten bereitstellen und aktualisieren, um die Clientbibliotheken von Cloud Translation Advanced zu verwenden.
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 in der Einrichtungsanleitung.
5. Verwenden Sie die Clientbibliotheken und Methoden von Cloud Translation Advanced. Bei Anfragen an Cloud Translation Advanced müssen Sie Ihre Projektnummer (oder Projekt-ID) und den Projektspeicherort angeben – normalerweise entweder global oder us-central1.
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. Für beide Versionen der API gelten die gleichen Tages- und Monatskontingente.
8. Prüfen Sie die Abrechnung auf mögliche Änderungen.

Wichtige Unterschiede zwischen Advanced und Basic

In folgenden Abschnitten werden die wichtigsten Unterschiede zwischen den Versionen Basic und Advanced beschrieben, damit Sie die Migrationsaufgaben besser verstehen.

Dienstkonten

Für Cloud Translation Basic können Sie authentifizierte Anfragen mit 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. Sie können sich deshalb nicht mit API-Schlüsseln beim Dienst authentifizieren. Stattdessen müssen Sie Dienstkonten für die Authentifizierung bei Cloud Translation Advanced verwenden.

Weitere Informationen finden Sie in der Einrichtungsanleitung.

IAM-Rollen

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

Wenn Sie Dienstkonten Berechtigungen zum Aufruf 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 in Details zu Cloud Translation Advanced.

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 Übersetzung mit Cloud Translation Basic anfordern, verwendet Google ein vortrainiertes NMÜ-Modell (Neuronale maschinelle Übersetzung). Für Cloud Translation Advanced können Sie das vortrainierte NMÜ-Modell oder ein benutzerdefiniertes AutoML Übersetzungsmodell verwenden.

Dienstkonten, die Sie für Übersetzungsanfragen verwenden, müssen die Berechtigungen für den Zugriff auf die NMÜ- und AutoML-Modelle haben, die sich in verschiedenen Projekten befinden können. Sie können beispielsweise ein zentrales Projekt haben, das Ihre Übersetzungsmodelle enthält, um die Wartung und Abrechnung zu vereinfachen. Dienstkonten in diesem oder anderen Projekten können diese Modelle verwenden, benötigen jedoch Berechtigungen.

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 an Cloud Translation Advanced sind beispielsweise Ressourcennamen erforderlich. Weitere Informationen finden Sie in der Übersicht zu Clientbibliotheken für Cloud Translation Advanced oder in der Kurzanleitung zum Übersetzen von Text (Advanced Edition).

Ressourcen, Projekte und Standorte

Für Anfragen an Cloud Translation Advanced ist der Name der Ressource erforderlich, die Sie verwenden möchten. Eine Ressource ist normalerweise ein qualifizierter Name, der den Projektnamen und seinen Standort enthält, der angibt, wo die Anfrage ausgeführt wird. Der Name eines AutoML-Modells ist beispielsweise ein Ressourcenname.

Wenn Ihr Google Cloud-Projekt beispielsweise 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/...

Beispielsweise lautet die URL, an die Sie eine getSupportedLanguages-Anfrage senden, in etwa so:

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

Hinweis: Alle Ressourcen in einer einzelnen Anfrage an Cloud Translation Advanced müssen denselben Standort haben. Derzeit werden nur die Standorte global und us-central1 unterstützt. Für alle benutzerdefinierten Ressourcen wie AutoML-Modelle und Glossare sowie für lang andauernde Vorgänge müssen Sie us-central1 nutzen. Sie können us-central1 auch verwenden, wenn Sie allgemeine Übersetzungsmodelle und Spracherkennung verwenden. Sie können den Standort global nur verwenden, wenn Sie allgemeine Übersetzungsmodelle und Spracherkennung verwenden.

Cloud Translation Advanced bietet auch multiregionale Endpunkte wie translate-eu.googleapis.com, um die Datenverarbeitung innerhalb der EU zu gewährleisten. Dies ist ein eindeutiger Endpunkt für die EU und keine Standorteinstellung für die globale API. Weitere Informationen finden Sie unter Globale und multiregionale Endpunkte.

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

Verwenden Sie Cloud Translation Advanced zum Übersetzen von Text, Erstellen von Glossaren oder für Batchanfragen.