Google Cloud Natural Language 拡張機能

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

バージョン 2.0.0

この拡張機能により、Google Cloud Natural Language API にアクセスできます。

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

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

操作

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 プロキシで使用するように構成してデプロイする場合は、以下のプロパティを使用します。

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

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

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

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