Text transkribieren

Bei der Transkription wird ein Skript mit nicht lateinischen Buchstaben in ein Skript mit lateinischen Buchstaben konvertiert. Das Skript mit lateinischen Buchstaben basiert auf der Aussprache der Ausgangssprache. Cloud Translation transkribiert beispielsweise die japanischen Zeichen こんにちは世界 in Kon'nichiwa sekai um.

Informationen dazu, welche Sprachen transkribiert werden können, finden Sie unter Unterstützung von Transkription und Transliteration.

Vorbereitung

Für die Verwendung der Cloud Translation API benötigen Sie ein Projekt, für das die Cloud Translation API aktiviert ist. Außerdem benötigen Sie die erforderlichen 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 transkribieren

REST

Verwenden Sie die Methode romanizeText, um ein Skript mit nicht lateinischen Buchstaben in ein Skript mit lateinischen Buchstaben zu konvertieren.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie folgende Werte:

PROJECT_NUMBER_OR_ID: die numerische oder alphanumerische ID Ihres Google Cloud -Projekts
LOCATION: die Region, in der Sie diesen Vorgang ausführen möchten. Beispiel: us-central1
SOURCE_LANGUAGE: der Sprachcode des Quelltextes
SOURCE_TEXT: der Text in der Ausgangssprache zur Transkription

HTTP-Methode und URL:

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText

JSON-Text der Anfrage:

{
  "source_language_code": "SOURCE_LANGUAGE",
  "contents": "SOURCE_TEXT"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch bei der gcloud CLI anmeldet. Um zu prüfen, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um zu prüfen, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "romanizations": [
    {
      "romanizedText": "ROMANIZED_TEXT"
    }
  ]
}

Weitere Informationen

Der Preis für die Transkription wird pro Zeichen berechnet. Weitere Informationen finden Sie unter Preise.