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,
  "glossary_config": {
    object TranslateTextGlossaryConfig)
  },
    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.
glossary_config

object (TranslateTextGlossaryConfig)

Optional. Glossar, das angewendet werden soll.

  • cloudtranslate.glossaries.predict

Antworttext

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