Method: projects.locations.batchTranslateDocument

大量のドキュメントを非同期バッチモードで翻訳します。この関数は、入力の処理中にリアルタイムで出力を提供します。呼び出し元がリクエストをキャンセルした場合でも、部分的な結果（入力ファイルの場合はすべてまたはなし）が指定された出力場所で使用できることがあります。

この呼び出しはすぐに返されます。google.longrunning.Operation.name を使用して、呼び出しのステータスをポーリングできます。

HTTP リクエスト

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

パスパラメータ

パラメータ
parent

string

必須。電話をかける場所。

形式: projects/{project-id}。

global ロケーションはバッチ翻訳ではサポートされていません。

同じリージョン（同じ location-id を持つ）内の用語集のみを使用できます。それ以外の場合は、INVALID_ARGUMENT（400）エラーが返されます。

リクエストの本文

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

JSON 表現 
{
  "sourceLanguageCode": string,
  "targetLanguageCodes": [
    string
  ],
  "inputConfigs": [
    {
      object (BatchDocumentInputConfig)
    }
  ],
  "outputConfig": {
    object (BatchDocumentOutputConfig)
  },
  "glossaries": {
    string: {
      object (TranslateTextGlossaryConfig)
    },
    ...
  },
  "formatConversions": {
    string: string,
    ...
  },
  "customizedAttribution": string,
  "enableShadowRemovalNativePdf": boolean,
  "enableRotationCorrection": boolean
}
フィールド
sourceLanguageCode

string

必須。入力ドキュメントの ISO-639 言語コード（わかっている場合）。例: 「en-US」、「sr-Latn」。サポートされている言語コードについては、サポートされている言語をご覧ください。
targetLanguageCodes[]

string

必須。入力ドキュメントの翻訳に使用する ISO-639 言語コード。ここに最大 10 個の言語コードを指定します。
inputConfigs[]

object (BatchDocumentInputConfig)

必須。入力構成。一致するファイルの合計数は 100 以下である必要があります。翻訳するコンテンツの合計サイズは、Unicode コードポイントで 1 億以下にする必要があります。ファイルは UTF-8 エンコードを使用する必要があります。
outputConfig

object (BatchDocumentOutputConfig)

必須。出力構成。2 つの入力構成が同じファイル（同じ入力パス）と一致する場合、重複する入力の出力は生成されません。
glossaries

map (key: string, value: object (TranslateTextGlossaryConfig))

省略可。適用する用語集。キーはターゲット言語コードです。
formatConversions

map (key: string, value: string)

省略可。すべての入力ファイルに適用されるファイル形式変換マップ。マップキーは元の mimeType です。マップ値は、変換されたドキュメントのターゲット mimeType です。

サポートされているファイル形式の変換には、application/pdf から application/vnd.openxmlformats-officedocument.wordprocessingml.document への変換が含まれます。

何も指定しない場合、出力ファイルは元のファイルと同じ形式になります。
customizedAttribution

string

省略可。このフラグは、ユーザーがカスタマイズしたアトリビューションをサポートするためのものです。指定しない場合、デフォルトは Machine Translated by Google です。カスタマイズされた帰属表示は、https://cloud.google.com/translate/attribution#attribution_and_logos のルールに準拠する必要があります。
enableShadowRemovalNativePdf

boolean

省略可。true の場合、テキスト削除サーバーを使用して、ネイティブ PDF 翻訳の背景画像のシャドウ テキストを削除します。シャドウ除去機能は、isTranslateNativePdfOnly: false && pdfNativeOnly: false
enableRotationCorrection

boolean

省略可。true の場合、DVS で自動回転補正を有効にします。

レスポンスの本文

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

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

BatchDocumentInputConfig

locations.batchTranslateDocument リクエストの入力構成。

JSON 表現 
{

  // Union field source can be only one of the following:
  "s3_source": {
    object (s3Source)
  }
  // End of list of possible types for union field source.
}
フィールド
共用体フィールド source。入力を指定します。source は次のいずれかになります。
s3_source

object (s3Source)

ソース入力の S3 バケットのロケーション。単一のファイルまたはワイルドカードを指定できます。

ファイルの MIME タイプは拡張子に基づいて決定されます。サポートされている MIME タイプは次のとおりです。

  • pdf: application/pdf
  • docx: application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • pptx: application/vnd.openxmlformats-officedocument.presentationml.presentation
  • xlsx: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

.docx、.pptx、.xlsx でサポートされる最大ファイルサイズは 100 MB です。.pdf でサポートされる最大ファイルサイズは 1 GB、最大ページ数は 1,000 ページです。すべての入力ドキュメントでサポートされる最大ファイルサイズは 1 GB です。

BatchDocumentOutputConfig

locations.batchTranslateDocument リクエストの出力構成。

JSON 表現 
{

  // Union field destination can be only one of the following:
  "s3_destination": {
    object (s3Destination)
  }
  // End of list of possible types for union field destination.
}
フィールド
共用体フィールド destination。出力先。指定された宛先ディレクトリが存在し、空である必要があります。destination は次のいずれかになります。
s3_destination

object (s3Destination)

出力コンテンツの S3 バケットの宛先。入力ドキュメントごとに、最大 2 * n 個の出力ファイルが生成されます。（n は BatchTranslateDocumentRequest 内のターゲット言語コードの数です）。

リクエストで targetLanguageCode が提供されている。