Method: projects.translateText

入力テキストを翻訳し、翻訳されたテキストを返します。

HTTP リクエスト

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

パスパラメータ

パラメータ
parent

string

必須。呼び出しを行うプロジェクト。呼び出し元のプロジェクトを参照する必要があります。

形式: /projects/{project-id}

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "contents": [
    string
  ],
  "mime_type": string,
  "source_language_code": string,
  "target_language_code": string,
  "glossary_config": {
    object TranslateTextGlossaryConfig)
  },
    string: string,
    ...
  }
}
フィールド
contents[]

string

必須。入力コンテンツ(文字列形式)。コンテンツの合計は 30k コードポイント未満にすることをおすすめします。このフィールドの最大長は 1,024 です。

mime_type

string

省略可。ソーステキストの形式(「text/html」、「text/plain」など)。空白のままにすると、MIME タイプはデフォルトで「text/html」になります。

source_language_code

string

省略可。入力テキストの BCP-47 言語コード(わかっている場合)。例: 「en-US」、「sr-Latn」。サポートされている言語コードは、言語サポートに記載されています。ソース言語が指定されていない場合、API はソース言語を自動的に特定しようとし、レスポンス内でソース言語を返します。

target_language_code

string

必須。入力テキストの翻訳に使用する BCP-47 言語コード。言語サポートに記載されている言語コードのいずれかに設定します。

glossary_config

object (TranslateTextGlossaryConfig)

省略可。適用する用語集。

  • cloudtranslate.glossaries.predict

レスポンスの本文

成功した場合、レスポンスの本文には TranslateTextResponse のインスタンスが含まれます。