翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ターゲット感情の非同期分析
<a name="using-api-targeted-sentiment"></a>

ターゲット感情のリアルタイム分析の詳細については、「[ターゲット感情のリアルタイム分析](using-api-sync.md#get-started-api-targeted-sentiment)」を参照してください。

Amazon Comprehend には、非同期のターゲット感情分析を開始および管理するための次の API オペレーションがあります。
+  [StartTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartTargetedSentimentDetectionJob.html) – ドキュメントのコレクションに対する非同期ターゲット感情検出ジョブを開始します。
+  [ListTargetedSentimentDetectionJobs](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListTargetedSentimentDetectionJobs.html) – 送信されたターゲット感情検出ジョブのリストを返します。
+  [DescribeTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeTargetedSentimentDetectionJob.html) — 指定されたターゲット感情検出ジョブに関連するプロパティ (ステータスを含む) を取得します。
+  [StopTargetdSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StopTargetedSentimentDetectionJob.html) — 進行中の指定されたターゲット感情ジョブを停止します。

**Topics**
+ [開始する前に](#api-targeted-sentiment-before)
+ [を使用したターゲット感情の分析 AWS CLI](#api-targeted-sentiment-cli)

## 開始する前に
<a name="api-targeted-sentiment-before"></a>

始める前に、次の有無を確認します。
+ **入出力バケット** — 入出力に使用する Amazon S3 バケットを指定します。バケットは、呼び出す API と同じリージョンに存在している必要があります。
+ **IAM サービスロール** — 入出力バケットにアクセス許可を持つ IAM サービスロールが必要です。詳細については、「[バッチ操作に必要なロールベースのアクセス許可](security_iam_id-based-policy-examples.md#auth-role-permissions)」を参照してください。

## を使用したターゲット感情の分析 AWS CLI
<a name="api-targeted-sentiment-cli"></a>

次の例は、 AWS CLIで `StartTargetedSentimentDetectionJob` オペレーションを使用する方法を示しています。この例では、入力テキストの言語を指定します。

例は、Unix、Linux、および macOS 用にフォーマットされています。Windows の場合は、各行末のバックスラッシュ (\$1) Unix 連結文字をキャレット (^) に置き換えてください。

```
aws comprehend start-targeted-sentiment-detection-job \
       --job-name "job name" \
       --language-code "en" \
       --cli-input-json file://path to JSON input file
```

次の例に示すように、`cli-input-json` パラメータには、リクエストデータを含む JSON ファイルへのパスを指定します。

```
{
    "InputDataConfig": {
        "S3Uri": "s3://input bucket/input path",
        "InputFormat": "ONE_DOC_PER_FILE"
    },
    "OutputDataConfig": {
        "S3Uri": "s3://output bucket/output path"
    },
    "DataAccessRoleArn": "arn:aws:iam::account ID:role/data access role"
}
```

ジョブの開始リクエストが成功すると、以下のようなレスポンスが返されます。

```
{
    "JobStatus": "SUBMITTED",
    "JobArn": "job ARN"
    "JobId": "job ID"
}
```