Google Cloud Natural Language 拡張機能

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください。 情報

バージョン 1.4.1

Google Cloud Natural Language API へのアクセス権を付与します。

この拡張機能を使用すると、カテゴリを適用してコンテンツを分類できるほか、コンテンツの感情を正から負のスケールで分析できます。

ここでは、この拡張機能の構成と使用について説明します。Apigee コンソールを使用して拡張機能を構成する手順については、拡張機能の追加と構成をご覧ください。

アクション

classifyContent

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

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

リクエスト パラメータ

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
パラメータ 説明 種類 デフォルト 必須
data 分析するコンテンツ。 文字列 なし。 はい、できます。

レスポンス

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

sentenceSentiment

与えられたテキストを分析し、そのテキスト内の感情的傾向を特定します。特に、ライターの態度がポジティブか、ネガティブか、ニュートラルかを判断します。

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

リクエスト パラメータ

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
パラメータ 説明 種類 デフォルト 必須
data 分析するコンテンツ。 文字列 なし。 はい、できます。

レスポンス

ドキュメント全体と各文の感情スコア（配列）を含むオブジェクト。ドキュメントとその文の両方について、次のプロパティが含まれます。

  • 分析されたコンテンツが含まれる Content プロパティ。
  • コンテンツの感情を、ポジティブ（正の数）からネガティブ（負の数）までの 1 ～ 1 の範囲で示す Score プロパティ。
  • コンテンツ内の感情の総合的な強さ（ポジティブとネガティブの両方）を 0.0 ～+inf の範囲で示す Magnitude プロパティ。

entitySentiment

指定されたテキストを分析して、テキスト内の各エンティティについて表現されている感情（ポジティブまたはネガティブ）を判断します。エンティティの感情は、数値スコアとマグニチュード値によって表され、エンティティの言及ごとに決定されます。このスコアを集計して、そのエンティティの全体的な感情スコアと強度が計算されます。

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

リクエスト パラメータ

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
パラメータ 説明 種類 デフォルト 必須
data 分析するコンテンツ。 文字列 なし。 はい、できます。

レスポンス

テキスト内のエンティティの感情スコアを含むオブジェクトの配列。ドキュメントとその文の両方について、次のプロパティが含まれます。

  • Name プロパティ。
  • エンティティのタイプを記述する Type プロパティ。
  • エンティティの感情を 1 ～ 1 のスコア（正（正の数）から負（負の数値））で示す Score プロパティ。
  • エンティティに対する感情の強さ（ポジティブとネガティブの両方）を示す Magnitude プロパティ。0.0 ～+inf の値で表されます。

構成リファレンス

API プロキシで使用するためにこの拡張機能を構成およびデプロイする場合は、以下を使用します。

共通の拡張プロパティ

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

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

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

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

プロパティ 説明 デフォルト 必須
証明書 これは、Apigee Edge コンソールで入力する場合、サービス アカウント キー ファイルの内容です。Management API 経由で送信される場合は、サービス アカウント キー ファイルから生成された、Base64 エンコードの値です。 なし。 はい、できます。