翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DetectSentiment
テキストを検査し、優勢なセンチメントの推論を返します (POSITIVE,NEUTRAL,MIXED, またはNEGATIVE).
リクエストの構文
{
"LanguageCode": "string",
"Text": "string"
}リクエストパラメータ
すべてのアクションに共通のパラメータについては、「」を参照してください。共通パラメータ。
リクエストは以下のデータを JSON 形式で受け入れます。
- LanguageCode
-
入力ドキュメントの言語。Amazon Comprehend でサポートされる主要な言語のいずれかを指定できます。すべてのドキュメントは同じ言語である必要があります。
Type: 文字列
有効な値:
en | es | fr | de | it | pt | ar | hi | ja | ko | zh | zh-TW: 必須 はい
- Text
-
UTF-8 テキスト文字列。各文字列には UTF-8 エンコード文字の 5,000 バイトの UTF-8 エンコード文字を 5,000 バイトの UTF-
Type: 文字列
長さ制約: 最小長は 1 です｡
: 必須 はい
レスポンスの構文
{
"Sentiment": "string",
"SentimentScore": {
"Mixed": number,
"Negative": number,
"Neutral": number,
"Positive": number
}
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- Sentiment
-
Amazon Comprehend が最高レベルの信頼度を持っていると推測されるセンチメント。
Type: 文字列
有効な値:
POSITIVE | NEGATIVE | NEUTRAL | MIXED - SentimentScore
-
センチメントとそれに対応する信頼度をリストするオブジェクト。
タイプ: SentimentScore オブジェクト
Errors
すべてのアクションに共通のエラーについては、「一般的なエラー」を参照してください。
- InternalServerException
-
内部サーバーエラーが発生しました。リクエストを再実行します。
HTTP ステータスコード: 500
- InvalidRequestException
-
リクエストは無効でした。
HTTP ステータスコード: 400
- TextSizeLimitExceededException
-
入力テキストのサイズが制限を超えています。小さなドキュメントを使用してください。
HTTP ステータスコード: 400
- UnsupportedLanguageException
-
Amazon Comprehend は、入力テキストの言語を処理できません。カスタムエンティティ認識 API の場合、英語、スペイン語、フランス語、イタリア語、ドイツ語、またはポルトガル語のみが受け入れられます。サポートされている言語のリストについては、「Amazon Comprehend でサポートされる言語」を参照してください。
HTTP ステータスコード: 400
Examples
感情を検出する
入力テキストが「今日は私の誕生日です、私はとても幸せです。 「の場合、オペレーションは以下のレスポンスを返します。
{ "SentimentScore": { "Mixed": 0.0033542951568961143, "Positive": 0.9869875907897949, "Neutral": 0.008563132025301456, "Negative": 0.0010949420975521207 }, "Sentiment": "POSITIVE", } }
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください。
