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

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

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

始める前に

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

  1. Cloud Translation API(translate.googleapis.com)を有効にします。

    Cloud Translation API を有効にする

  2. 認証プロファイルを作成します。Apigee Integration は、認証プロファイルを使用して、翻訳 - ドキュメント タスクの認証エンドポイントに接続します。

    サービス アカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。

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

  1. Apigee UI で、Apigee 組織を選択します。
  2. [Develop] > [Integrations] の順にクリックします。
  3. 既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。

    新しいインテグレーションを作成する場合:

    1. [Create Integration] ダイアログで名前と説明を入力します。
    2. サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
    3. [Create] をクリックします。

    インテグレーション デザイナーでインテグレーションが開きます。

  4. 統合デザイナーのナビゲーション バーで、[+ +Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
  5. [Translate - Document] 要素をクリックして、統合デザイナーに配置します。
  6. デザイナーで [Translate - Document] 要素をクリックし、[Translate - Document] タスク構成ペインを表示します。
  7. [Authentication] に移動し、使用する既存の認証プロファイルを選択します。

    省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ New authentication profile] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。

  8. [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 まで(ページ数の上限なし)

エラー処理方法

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

次のステップ

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