翻訳 - ドキュメントタスク

翻訳 - ドキュメント タスクを使用すると、Cloud Translation で単一のドキュメントファイルをリアルタイムで（同期して）翻訳できます。PDF や DOCX などの書式設定されたドキュメントを、元の書式とレイアウトを保持しながら直接翻訳できます。ドキュメントの翻訳でサポートされているファイル形式については、サポートされているファイル形式をご覧ください。

Cloud Translation は、自動言語検出機能によって 100 を超える言語ペアのテキストを翻訳できる Google Cloud サービスです。サポートされる言語については、サポートされる言語をご覧ください。

始める前に

翻訳 - ドキュメント タスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。

Cloud Translation API（translate.googleapis.com）を有効にします。
Cloud Translation API を有効にする
認証プロファイルを作成します。Apigee Integration は、認証プロファイルを使用して、翻訳 - ドキュメント タスクの認証エンドポイントに接続します。
サービスアカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。

翻訳 - ドキュメントタスクを構成する

Apigee UI で、Apigee 組織を選択します。
[Develop] > [Integrations] の順にクリックします。
既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。
新しいインテグレーションを作成する場合:
1. [Create Integration] ダイアログで名前と説明を入力します。
2. サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
3. [Create] をクリックします。
インテグレーションデザイナーでインテグレーションが開きます。
統合デザイナーのナビゲーションバーで、[+ +Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
[Translate - Document] 要素をクリックして、統合デザイナーに配置します。
デザイナーで [Translate - Document] 要素をクリックし、[Translate - Document] タスク構成ペインを表示します。
[Authentication] に移動し、使用する既存の認証プロファイルを選択します。
省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ New authentication profile] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。
[Task Input] に移動し、次の「タスクの入力パラメータ」の表を使用して表示される入力フィールドを構成します。
入力フィールドの変更は自動的に保存されます。

タスクの入力パラメータ

次の表に、翻訳 - ドキュメント タスクの入力パラメータを示します。

プロパティ	データ型	説明
Region	文字列	翻訳オペレーションを実行するリージョン。例: `us-central1`
ProjectsId	文字列	Google Cloud プロジェクト ID。
リクエスト	JSON	リクエスト JSON 構造をご覧ください。インラインのドキュメント翻訳の場合、リクエスト JSON の `mimeType` フィールドを指定する必要があります。

タスク出力

翻訳 - ドキュメント タスクは、次の出力例のような翻訳されたドキュメントを返します。

{
    "documentTranslation": {
        "byteStreamOutputs": ["BYTE_STREAM"],
        "mimeType": "MIME_TYPE"
    },
    "model": "projects/[PROJECT_NUMBER]/locations/[LOCATION]/models/general/nmt"
}

サポートされているファイル形式

Cloud Translation は、次の入力ファイル形式と、それに関連する出力ファイル形式をサポートしています。ドキュメントファイルサイズの上限については、ドキュメントファイルサイズの上限をご覧ください。

入力	ドキュメントの MIME タイプ	出力
DOC	application/msword	DOC、DOCX
DOCX	application/vnd.openxmlformats-officedocument.wordprocessingml.document	DOCX
PDF	application/pdf	PDF、DOCX
PPT	application/vnd.ms-powerpoint	PPT、PPTX
PPTX	application/vnd.openxmlformats-officedocument.presentationml.presentation	PPTX
XLS	application/vnd.ms-excel	XLS、XLSX
XLSX	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	XLSX

ドキュメントのファイルサイズの上限

ファイル形式	サイズの上限
PDF	20 MB まで
ネイティブ PDF （`isTranslateNativePdfOnly` フィールドを `true` に設定する必要があります）	20 MB まで（上限 300 ページ）
スキャンされた PDF	20 MB まで（上限 20 ページ）
その他のファイル形式	20 MB まで（ページ数の上限なし）

エラー処理方法

タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式の使用方法と、さまざまな種類のエラー処理方式の詳細については、エラー処理の方式をご覧ください。

次のステップ

エッジとエッジの条件を追加する。
インテグレーションをテストして公開する。
トリガーを構成する。
データマッピングタスクを追加する。
Google Cloud サービス向けのすべてのタスクを確認する。