ドキュメントを同期モードで翻訳します。
HTTP リクエスト
POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{parent}:translateDocument
パスパラメータ
パラメータ | |
---|---|
parent |
必須。リージョン呼び出しを行う場所。 形式: グローバル呼び出しには、 AutoML モデルまたはカスタム用語集を使用するリクエストには、非グローバル ロケーションが必要です。 モデルと用語集は同じリージョン(同じ location-id)に存在する必要があります。そうでない場合は、INVALID_ARGUMENT(400)エラーが返されます。 |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "sourceLanguageCode": string, "targetLanguageCode": string, "documentInputConfig": { object ( |
フィールド | |
---|---|
sourceLanguageCode |
省略可。入力ドキュメントの ISO-639 言語コード(わかっている場合)。例: 「en-US」、「sr-Latn」。サポートされている言語コードは、言語サポートに記載されています。ソース言語が指定されていない場合、API はソース言語を自動的に特定しようとし、レスポンス内でソース言語を返します。リクエストに用語集またはカスタムモデルが含まれている場合は、ソース言語を指定する必要があります。 |
targetLanguageCode |
必須。入力ドキュメントの翻訳に使用する ISO-639 言語コード。言語サポートに記載されている言語コードのいずれかに設定します。 |
documentInputConfig |
必須。入力構成。 |
glossaryConfig |
省略可。適用する用語集。用語集はモデルと同じリージョン(同じ location-id)に存在する必要があります。そうでない場合は、INVALID_ARGUMENT(400)エラーが返されます。 認可には、指定されたリソース
|
レスポンスの本文
翻訳されたドキュメントのレスポンス メッセージ。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "documentTranslation": { object ( |
フィールド | |
---|---|
documentTranslation |
翻訳されたドキュメント。 |
glossaryDocumentTranslation |
リクエストで用語集が指定されている場合、ドキュメントの翻訳出力。用語集の用語が適用されない場合は、[TranslateDocumentResponse.document_translation] と同じになります。 |
glossaryConfig |
この翻訳に使用された |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/cloud-translation
https://www.googleapis.com/auth/cloud-platform
DocumentInputConfig
ドキュメント翻訳リクエストの入力構成。
JSON 表現 |
---|
{
"mimeType": string,
"content": string,
"S3Source": {
object ( |
フィールド | |
---|---|
mimeType |
入力ドキュメントの mimeType を指定します。 指定しない場合は、S3Source で指定されたファイルの拡張子を使用して決定されます。バイト コンテンツで提供されるファイルの場合、mimeType を指定する必要があります。 現在サポートされている MIME タイプは次のとおりです。
サポートされているファイル形式は
|
content |
バイト ストリームとして表されるドキュメントのコンテンツ。 Base64 でエンコードされた文字列。 |
S3Source |
入力コンテンツの保存場所。 |
DocumentTranslation
翻訳されたドキュメント メッセージ。
JSON 表現 |
---|
{ "byteStreamOutputs": [ string ], "mimeType": string, "detectedLanguageCode": string } |
フィールド | |
---|---|
byteStreamOutputs[] |
変換されたドキュメントの配列。現時点ではサイズ 1 になることが想定されています。今後、他の種類のファイル形式についても複数の翻訳ドキュメントが作成される可能性があります。 Base64 でエンコードされた文字列。 |
mimeType |
翻訳されたドキュメントの MIME タイプ。 |
detectedLanguageCode |
入力ドキュメントで検出された言語。ユーザーが入力ドキュメントのソース言語を指定しなかった場合、このフィールドには自動的に検出された言語コードが設定されます。ソース言語が渡された場合、言語の自動検出は行われず、このフィールドは空になります。 |