Method: projects.translateText

Übersetzt Eingabetext und gibt übersetzten Text zurück.

HTTP-Anfrage

POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{parent}:translateText

Pfadparameter

Parameter
parent

string

Erforderlich. Projekt zum Anrufen. Muss sich auf das Projekt eines Anrufers beziehen.

Format: /projects/{project-id}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "contents": [
    string
  ],
  "mime_type": string,
  "source_language_code": string,
  "target_language_code": string,
    string: string,
    ...
  }
}
Felder
contents[]

string

Erforderlich. Der Inhalt der Eingabe im Stringformat. Wir empfehlen, dass der gesamte Inhalt weniger als 30.000 Codepoints umfasst. Die maximale Länge dieses Feldes beträgt 1.024 Zeichen.
mime_type

string

Optional. Das Format des Quelltexts, z. B. „text/html“ oder „text/plain“. Wenn Sie hier nichts eingeben, wird standardmäßig der MIME-Typ „text/html“ verwendet.
source_language_code

string

Optional. Der BCP-47-Sprachcode des Eingabetexts, falls bekannt, z. B. „en-US“ oder „sr-Latn“. Die unterstützten Sprachcodes finden Sie unter „Sprachunterstützung“. Wenn die Ausgangssprache nicht angegeben ist, versucht die API, sie automatisch zu ermitteln, und gibt sie in der Antwort zurück.
target_language_code

string

Erforderlich. Der BCP-47-Sprachcode, der für die Übersetzung des Eingabetexts verwendet werden soll. Er muss auf einen der unter „Sprachunterstützung“ aufgeführten Sprachcodes festgelegt sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von TranslateTextResponse.