Google Cloud Natural Language 拡張機能

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します。
info

バージョン 1.4.1

Google Cloud Natural Language API へのアクセスを提供します。

この拡張機能を使用すると、カテゴリを適用してコンテンツを分類したり、ポジティブからネガティブのスケールでコンテンツの感情を分析したりできます。

このコンテンツでは、この拡張機能を構成して使用するためのリファレンスを提供します。Apigee コンソールを使用して拡張機能を構成する手順については、拡張機能の追加と構成をご覧ください。

操作

classifyContent

テキストの一部を分析し、そのテキストに適用されるコンテンツ カテゴリのリストを返します。

Natural Language API のこの機能について詳しくは、コンテンツの分類とコンテンツ カテゴリをご覧ください。

リクエスト パラメータ

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
パラメータ 説明 型 デフォルト 必須
データ 分析対象のコンテンツ。 文字列 なし。 はい。

レスポンス

カテゴリ配列。各アイテムには、コンテンツを分類するためのカテゴリと信頼度スコアが含まれます。

sentenceSentiment

指定されたテキストを分析して、そのテキストに反映されている感情的な考え方を明かにします。具体的には、執筆者の考え方がポジティブか、ネガティブか、ニュートラルかを判断します。

Natural Language API のこの機能について詳しくは、感情の分析とNatural Language API の基本をご覧ください。

リクエスト パラメータ

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
パラメータ 説明 型 デフォルト 必須
データ 分析対象のコンテンツ。 文字列 なし。 はい。

レスポンス

ドキュメント全体と、ドキュメントに含まれる各センテンスに対する感情スコアを(配列として)格納するオブジェクト。ドキュメントとセンテンスの両方に、次のプロパティが含まれます。

  • Content プロパティ。分析されたコンテンツを示します。
  • Score プロパティ。コンテンツに反映されている感情を 1 から -1 の範囲で示します。正の数値はポジティブな感情を意味し、負の数値はネガティブな感情を意味します。
  • Magnitude プロパティ。コンテンツ全体に反映されている感情(ポジティブとネガティブの両方)の強度を 0.0 から +inf の範囲で示します。

entitySentiment

指定されたテキストを分析して、テキスト内の各エンティティについて表現されている感情(ポジティブまたはネガティブ)を判断します。エンティティの感情は数値スコアと強度の値で表され、エンティティが言及されるたびに判断されます。このスコアを集計して、そのエンティティの全体的な感情スコアと強度が計算されます。

Google Cloud Natural Language API のエンティティ分析について詳しくは、エンティティ感情分析と感情分析の値の解釈をご覧ください。

リクエスト パラメータ

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
パラメータ 説明 型 デフォルト 必須
データ 分析対象のコンテンツ。 文字列 なし。 はい。

レスポンス

テキストに含まれるエンティティに対する感情スコアを格納するオブジェクトの配列。ドキュメントとセンテンスの両方に、次のプロパティが含まれます。

  • Name プロパティ。
  • Type プロパティ。エンティティの型を表します。
  • Score プロパティ。エンティティに対する感情を 1 から -1 の範囲で示します。正の数値はポジティブな感情を意味し、負の数値はネガティブな感情を意味します。
  • Magnitude プロパティ。エンティティに対する感情(ポジティブとネガティブの両方)の強度を 0.0 から +inf の範囲で示します。

構成リファレンス

この拡張機能を API プロキシで使用するように構成してデプロイする場合は、以下のプロパティを使用します。

拡張機能の共通プロパティ

すべての拡張機能には次のプロパティがあります。

プロパティ 説明 デフォルト 必須
name この拡張機能に付ける名前。 なし ○
packageName Apigee Edge から提供された拡張機能パッケージの名前。 なし ○
version 拡張機能を構成する拡張機能パッケージのバージョン番号。 なし ○
configuration 追加する拡張機能に固有の構成値。この拡張機能パッケージのプロパティをご覧ください。 なし ○

この拡張機能パッケージのプロパティ

この拡張機能に固有の次の構成プロパティの値を指定します。

プロパティ 説明 デフォルト 必須
credentials Apigee Edge コンソール内で入力する場合は、サービス アカウント キーのファイルの内容です。管理 API を使用して設定する場合は、サービス アカウント キー のファイルから生成された、base64 でエンコード済みの値です。 なし。 はい。