言語 - テキストアノテーションタスク

言語 - テキストアノテーション タスクによって、Cloud Natural Language を使用して、所与のテキストに感情分析、エンティティ分析、構文解析などのいくつかの自然言語オペレーションを実行できます。

始める前に

言語 - テキストアノテーション タスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。

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

言語 - テキストアノテーションタスクを構成する

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

タスクの入力パラメータ

次の表に、[言語 - テキストアノテーション] タスクの入力パラメータを示します。

プロパティ	データ型	説明
Region	文字列	アノテーションオペレーションを実行するリージョン。例: `us-central1`
ProjectsId	文字列	Google Cloud プロジェクト ID。
リクエスト	JSON	リクエスト JSON 構造をご覧ください。サポートされている Natural Language オペレーションについては、サポートされている Natural Language オペレーションをご覧ください。

タスク出力

言語 - テキストアノテーション タスクは、実行されたオペレーションに応じてレスポンス出力を返します。構文解析を実行した際の出力例は次のとおりです。

{
    "sentences": [
        ... Array of sentences with sentence information
    ],
    "tokens": [
        ... Array of tokens with token information
    ]
}

サポートされている Natural Language オペレーション

言語 - テキストアノテーション タスクでは、次の Natural Language オペレーションを実行できます。

感情分析: 感情分析を使用して、所与のテキストの感情的な傾向（ポジティブか、ネガティブか、ニュートラルか）を特定および判断します。このオペレーションを実行するには、リクエスト JSON の extractDocumentSentiment フィールドを true に設定します。
エンティティ分析: エンティティ分析を使用して、特定のテキストから、固有名詞や普通名詞などのエンティティの検査と取得を行います。このオペレーションを実行するには、リクエスト JSON の extractEntities フィールドを true に設定します。
構文解析: 構文解析を使用して、所与のテキストから言語情報を抽出します。このオペレーションを実行するには、リクエスト JSON の extractSyntax フィールドを true に設定します。

エラー処理方法

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

次のステップ

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