In diesem Dokument wird beschrieben, wie Sie mit Cloud Translation Basic (v2) Text übersetzen.
Der eingegebene Text kann nur Text oder HTML sein. Cloud Translation Basic übersetzt keine HTML-Tags in der Eingabe, sondern nur Text, der zwischen den Tags angezeigt wird. Die Ausgabe behält die (nicht übersetzten) HTML-Tags mit dem übersetzten Text zwischen den Tags bei, soweit es aufgrund der Unterschiede zwischen der Ausgangs- und der Zielsprache möglich ist. Die Reihenfolge der HTML-Tags in der Ausgabe kann von der im Eingabetext abweichen, wenn durch die Übersetzung die Reihenfolge der Wörter im Satz geändert wurde.
Hinweis
Für die Verwendung der Cloud Translation API ist ein Projekt erforderlich, für das die Cloud Translation API aktiviert ist. Außerdem benötigen Sie die notwendigen Anmeldedaten. Sie können auch Clientbibliotheken für gängige Programmiersprachen installieren, um Aufrufe an die API zu ermöglichen. Weitere Informationen dazu finden Sie auf der Seite Einrichtung.
Text übersetzen
In diesem Abschnitt werden einige Möglichkeiten zum Anfordern von Übersetzungen vom Endpunkt https://translation.googleapis.com/language/translate/v2
beschrieben.
Eingabestrings übersetzen
REST
Senden Sie zum Übersetzen von Text einePOST
-Anfrage im JSON-Format. Geben Sie im Anfragetext die Sprache, in die übersetzt werden soll (target
), sowie den zu übersetzenden Text (q
) an. Sie können mehrere zu übersetzende Textsegmente festlegen, indem Sie mehrere q
-Felder oder eine Liste von Werten für das q
-Feld einfügen. Sie können maximal 128 Textsegmente angeben. Geben Sie die Zielsprachen mit den jeweiligen ISO-639-Codes an.
Das folgende Beispiel zeigt eine POST
-Anfrage, für die curl
oder PowerShell verwendet wurde. Im Beispiel wird das Zugriffstoken für ein Dienstkonto verwendet, das mit der Google Cloud Google Cloud CLI für das Projekt eingerichtet wurde.
Eine Anleitung zum Installieren der Google Cloud CLI, zum Einrichten eines Projekts mit einem Dienstkonto und zum Abrufen eines Zugriffstokens finden Sie auf der Seite Einrichtung.
Ersetzen Sie vor der Nutzung von Anfragedaten die folgenden Werte:
PROJECT_NUMBER_OR_ID
: Die numerische oder alphanumerische ID Ihres Projekts von Google Cloud
HTTP-Methode und URL:
POST https://translation.googleapis.com/language/translate/v2
JSON-Text der Anfrage:
{ "q": ["Hello world", "My name is Jeff"], "target": "de" }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
und führen Sie den folgenden Befehl aus:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/language/translate/v2"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
und führen Sie den folgenden Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/language/translate/v2" | Select-Object -Expand Content
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "data": { "translations": [ { "translatedText": "Hallo Welt", "detectedSourceLanguage": "en" }, { "translatedText": "Mein Name ist Jeff", "detectedSourceLanguage": "en" } ] } }
Das Array translations
enthält zwei translatedText
-Felder mit Übersetzungen in der angeforderten target
-Sprache (de
: Deutsch). Die Übersetzungen werden in der gleichen Reihenfolge aufgeführt wie das entsprechende Quellarray in der Anfrage.
Go
Folgen Sie dem Einrichtungsleitfaden für Go in der Cloud Translation-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel anwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Translation Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Translation zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Folgen Sie dem Einrichtungsleitfaden für Java in der Cloud Translation-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel anwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Translation Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Translation zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Folgen Sie dem Einrichtungsleitfaden für Node.js in der Cloud Translation-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel anwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Translation Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Translation zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Folgen Sie dem Einrichtungsleitfaden für Python in der Cloud Translation-Kurzanleitung zur Verwendung von Clientbibliotheken, bevor Sie dieses Beispiel anwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Translation Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Translation zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Weitere Sprachen
C#: Folgen Sie dem Einrichtungsleitfaden für C# auf der Seite der Clientbibliotheken und rufen Sie dann die Cloud Translation-Referenzdokumentation für .NET auf.
PHP: Folgen Sie dem Leitfaden zur Einrichtung von PHP auf der Seite der Clientbibliotheken und rufen Sie dann die Cloud Translation-Referenzdokumentation für PHP auf.
Ruby: Folgen Sie dem Leitfaden zur Einrichtung von Ruby auf der Seite der Clientbibliotheken und rufen Sie dann die Cloud Translation-Referenzdokumentation für Ruby auf.
Modellparameter
Wenn Sie eine Übersetzungsanfrage an Cloud Translation Basic stellen, wird Ihr Text mithilfe des NMÜ-Modells (neuronale maschinelle Übersetzung) von Google übersetzt. Es kann kein anderes Modell verwendet werden. Wenn Sie Text mit AutoML-Modellen übersetzen möchten, müssen Sie Cloud Translation Advanced verwenden.
Überzeugen Sie sich selbst
Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, mit dem sie sich dann von der Leistungsfähigkeit von Cloud Translation in der Praxis überzeugen können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
Cloud Translation kostenlos testenZusätzliche Ressourcen
- Unterstützung zur Behebung häufiger Probleme oder Fehler erhalten Sie auf der Seite Fehlerbehebung.