<ph type="x-smartling-placeholder"></ph>
現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細
<ph type="x-smartling-placeholder">
バージョン 1.4.1
Google Cloud Natural Language API へのアクセスを提供します。
この拡張機能を使用すると、カテゴリを適用してコンテンツを分類したり、コンテンツの感情を肯定的または否定的な尺度で分析したりできます。
ここでは、この拡張機能を構成して使用するためのリファレンスを提供します。Apigee コンソールを使用して拡張機能を構成する手順については、拡張機能の追加と構成をご覧ください。
操作
<ph type="x-smartling-placeholder">
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 プロパティ。
- コンテンツの感情をポジティブ（正の数）から負の数（負の数）まで 1 ～-1 のスケールで示す Score プロパティ。
- コンテンツの全体的な感情の強さ（ポジティブとネガティブの両方）を示す Magnitude プロパティ（0.0 ～+inf）。
entitySentiment
指定されたテキストを分析して、テキスト内の各エンティティについて表現されている感情（ポジティブまたはネガティブ）を特定します。エンティティの感情は、数値のスコアと強度の値によって表され、エンティティについて言及されるたびに判断されます。このスコアを集計して、そのエンティティの全体的な感情スコアと強度が計算されます。
Google Cloud Natural Language API でのエンティティ分析の詳細については、エンティティ感情分析と感情分析値の解釈をご覧ください。
リクエスト パラメータ
<Input><![CDATA[{
"data" : "content-to-analyze"
}]]></Input>
| パラメータ | 説明 | 型 | デフォルト | 必須 |
|---|---|---|---|---|
| データ | 分析するコンテンツ。 | 文字列 | なし。 | はい。 |
レスポンス
テキスト内のエンティティの感情スコアを含むオブジェクトの配列。ドキュメントとその文の両方について、次のプロパティが含まれます。
- の Name プロパティ。
- エンティティのタイプを表す Type プロパティ。
- エンティティの感情を、ポジティブ（正の数）からネガティブ（負の数）までの 1 ～-1 のスケールで示す Score プロパティ。
- エンティティの感情の強さ（ポジティブとネガティブの両方）を示す Magnitude プロパティ（0.0 ～+inf）。
構成リファレンス
API プロキシで使用するためにこの拡張機能を構成してデプロイする場合は、以下を使用します。
拡張機能の一般的なプロパティ
すべての拡張機能には次のプロパティがあります。
| プロパティ | 説明 | デフォルト | 必須 |
|---|---|---|---|
name |
この拡張機能に付ける名前。 | なし | ○ |
packageName |
Apigee Edge から提供された拡張機能パッケージの名前。 | なし | ○ |
version |
拡張機能を構成する拡張機能パッケージのバージョン番号。 | なし | ○ |
configuration |
追加する拡張機能に固有の構成値。この拡張機能パッケージのプロパティをご覧ください。 | なし | ○ |
この拡張機能パッケージのプロパティ
この拡張機能に固有の次の構成プロパティの値を指定します。
| プロパティ | 説明 | デフォルト | 必須 |
|---|---|---|---|
| credentials | Apigee Edge コンソールで入力する場合は、これがサービス アカウント キー ファイルの内容です。Management API 経由で送信する場合は、サービス アカウント キー ファイルから生成された base64 エンコード値になります。 | なし。 | はい。 |