翻訳 - テキストタスクを使用すると、Cloud Translation で入力テキストを翻訳できます。入力テキストにはプレーン テキストまたは HTML を使用できます。
Cloud Translation は、自動言語検出機能によって 100 を超える言語ペアのテキストを翻訳できる Google Cloud サービスです。サポートされる言語については、サポートされる言語をご覧ください。
始める前に
翻訳 - テキストタスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。
- Cloud Translation API（
translate.googleapis.com）を有効にします。 - 認証プロファイルを作成します。Apigee Integration は、認証プロファイルを使用して、翻訳 - テキストタスクの認証エンドポイントに接続します。
サービス アカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。
「翻訳 - テキスト」タスクを構成する
- Apigee UI で、Apigee 組織を選択します。
- [Develop] > [Integrations] の順にクリックします。
- 既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。
新しいインテグレーションを作成する場合:
- [Create Integration] ダイアログで名前と説明を入力します。
- サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
- [Create] をクリックします。
インテグレーション デザイナーでインテグレーションが開きます。
- 統合デザイナーのナビゲーション バーで、[+ +Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
- [Translate - Text] 要素をクリックして、統合デザイナーで配置します。
- デザイナーで [Translate - Text] 要素をクリックして、[Translate - Text] タスク構成ペインを表示します。
- [Authentication] に移動し、使用する既存の認証プロファイルを選択します。
省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ New authentication profile] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。
- [Task Input] に移動し、次の「タスクの入力パラメータ」の表を使用して表示される入力フィールドを構成します。
入力フィールドの変更は自動的に保存されます。
タスクの入力パラメータ
次の表に、翻訳 - テキストタスクの入力パラメータを示します。
| プロパティ | データ型 | 説明 |
|---|---|---|
| Region | 文字列 | 翻訳オペレーションを実行するリージョン。例: us-central1 |
| ProjectsId | 文字列 | Google Cloud プロジェクト ID。 |
| リクエスト | JSON | リクエスト JSON 構造をご覧ください。複数の入力テキストを翻訳するには、リクエスト本文の contents フィールドの文字列を指定します。例: "contents": ["Hello World", "This is an example text"] |
タスク出力
翻訳 - テキストタスクは、次のサンプル出力と同様に、翻訳された出力テキストを返します。
{
"translations": [
{
"translatedText": "Bonjour le monde",
},
{
"translatedText": "Ceci est un exemple de texte",
}
]
}
エラー処理方法
タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式の使用方法と、さまざまな種類のエラー処理方式の詳細については、エラー処理の方式をご覧ください。
次のステップ
- エッジとエッジの条件を追加する。
- インテグレーションをテストして公開する。
- トリガーを構成する。
- データ マッピング タスクを追加する。
- Google Cloud サービス向けのすべてのタスクを確認する。