翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # StartCallAnalyticsJob カスタマーサービスへの電話の音声を書き起こし、リクエストに含めることを選択した追加のリクエストパラメータを適用します。 Call Analyticsには、多くの標準的な文字起こし機能に加えて、通話の特徴、通話の要約、話者の感情、テキストトランスクリプトと音声ファイルの編集（オプション）があります。カスタムカテゴリを適用して、指定した条件にフラグを付けることもできます。これらの機能やインサイトについて詳しくは、「Call [Analytics によるコールセンターの音声の分析](https://docs.aws.amazon.com/transcribe/latest/dg/call-analytics.html)」を参照してください。 Call Analyticsジョブにカテゴリを適用する場合は、ジョブリクエストを送信する前にカテゴリを作成する必要があります。カテゴリーをジョブに遡って適用することはできません。新しいカテゴリを作成するには、[CreateCallAnalyticsCategory](API_CreateCallAnalyticsCategory.md)オペレーションを使用します。通話分析カテゴリの詳細については、「[通話後の文字起こし用のカテゴリの作成」と「[リアルタイムの文字起こし用のカテゴリの作成](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html)](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html)」を参照してください。 `StartCallAnalyticsJob`リクエストを行うには、まずメディアファイルを Amazon S3 バケットにアップロードする必要があります。次に、`Media`パラメータを使用してファイルの Amazon S3 ロケーションを指定できます。 `StartCallAnalyticsJob`リクエストには次のパラメータが含まれます。 + `region`:AWS リージョン リクエストを送信している場所。Amazon TranscribeAWS リージョン でサポートされているリストについては、「[Amazon Transcribe エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/transcribe.html)」を参照してください。 + `CallAnalyticsJobName`: 文字起こしジョブ用に作成する、社内独自のカスタム名AWS アカウント。 + `DataAccessRoleArn`: 入力ファイルを含む Amazon S3 バケットにアクセスするために必要なアクセス許可がある、IAM ロールの Amazon リソースネーム (ARN)。 + `Media`(`MediaFileUri`または`RedactedMediaFileUri`): メディアファイルの Amazon S3 の場所。 **注記** Call Analyticsでは、入力オーディオの場所を指定する代わりに`RedactedMediaFileUri``MediaFileUri`、メディアファイルに含まれるオーディオを編集できます。オーディオを編集することを選択した場合、`RedactedMediaFileUri`編集されたメディアは回答欄で指定された場所で見つけることができます。 ## リクエストの構文 ``` { "CallAnalyticsJobName": "string", "ChannelDefinitions": [ { "ChannelId": number, "ParticipantRole": "string" } ], "DataAccessRoleArn": "string", "Media": { "MediaFileUri": "string", "RedactedMediaFileUri": "string" }, "OutputEncryptionKMSKeyId": "string", "OutputLocation": "string", "Settings": { "ContentRedaction": { "PiiEntityTypes": [ "string" ], "RedactionOutput": "string", "RedactionType": "string" }, "LanguageIdSettings": { "string" : { "LanguageModelName": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } }, "LanguageModelName": "string", "LanguageOptions": [ "string" ], "VocabularyFilterMethod": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } } ``` ## リクエストパラメータ すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは以下の JSON 形式のデータを受け入れます。 ** [CallAnalyticsJobName](#API_StartCallAnalyticsJob_RequestSyntax) ** コール分析ジョブ用に自分で選んだユニークな名前。 この名前は大文字と小文字が区別され、スペースを含めることはできません。また、内では一意でなければなりませんAWS アカウント。既存のジョブと同じ名前の新しいジョブを作成しようとすると、`ConflictException`エラーが発生します。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 200 です。 パターン: `^[0-9a-zA-Z._-]+` 必須: はい ** [ChannelDefinitions](#API_StartCallAnalyticsJob_RequestSyntax) ** どのスピーカーがどのチャンネルにあるかを指定できます。たとえば、エージェントが最初に発言した参加者であれば、`0` (最初のチャンネルを示す) と`ParticipantRole``AGENT` (エージェントが話していることを示す)`ChannelId` に設定します。 型: [ChannelDefinition](API_ChannelDefinition.md) オブジェクトの配列 配列メンバー: 2 項目の定数。 必須: いいえ ** [DataAccessRoleArn](#API_StartCallAnalyticsJob_RequestSyntax) ** 入力ファイルを含む Amazon S3 バケットにアクセスするために必要なアクセス許可がある、IAM ロールの Amazon リソースネーム (ARN)。指定したロールに、指定した Amazon S3 ロケーションにアクセスするための適切な権限がない場合、リクエストは失敗します。 IAM ロール ARN には次の形式があります`arn:partition:iam::account:role/role-name-with-path`。例: `arn:aws:iam::111122223333:role/Admin`。 詳細については、[IAM の ARN](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns) を参照してください。 タイプ: 文字列 長さの制限: 最小長は 20 です。最大長は 2,048 です。 パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$` 必須: いいえ ** [Media](#API_StartCallAnalyticsJob_RequestSyntax) ** Call Analytics リクエストで使用するメディアファイルの Amazon S3 の場所について説明します。 型: [Media](API_Media.md) オブジェクト 必須: はい ** [OutputEncryptionKMSKeyId](#API_StartCallAnalyticsJob_RequestSyntax) ** コール分析出力の暗号化に使用する KMS キー **現在のキーを使用する場合は**AWS アカウント、次の 4 つの方法のいずれかで KMS キーを指定できます。 1. KMS キー ID 自体を使用してください。例えば、`1234abcd-12ab-34cd-56ef-1234567890ab`。 1. KMS キー ID にはエイリアスを使用します。例えば、`alias/ExampleAlias`。 1. KMS キー ID には、Amazon リソースネーム (ARN) が使用されます。例えば、`arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`。 1. KMS キーエイリアスには ARN を使用してください。例えば、`arn:aws:kms:region:account-ID:alias/ExampleAlias`。 **AWS アカウント現在のキーとは異なるキーを使用する場合は**AWS アカウント、次の 2 つの方法のいずれかで KMS キーを指定できます。 1. KMS キー ID には ARN を使用してください。例えば、`arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`。 1. KMS キーエイリアスには ARN を使用してください。例えば、`arn:aws:kms:region:account-ID:alias/ExampleAlias`。 暗号化キーを指定しない場合、出力はデフォルトの Amazon S3 キー (SSE-S3) で暗号化されます。 KMS キーを指定して出力を暗号化する場合は、`OutputLocation`パラメータを使用して出力場所も指定する必要があります。 [StartCallAnalyticsJob](#API_StartCallAnalyticsJob)リクエストを行うロールには、指定された KMS キーを使用する許可がある必要があるコントロール タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 2,048 です。 パターン: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` 必須: いいえ ** [OutputLocation](#API_StartCallAnalyticsJob_RequestSyntax) ** コール分析の文字起こし出力を保存する Amazon S3 の場所。出力場所を指定するには、次のいずれかの形式を使用できます。 1. s3://DOC-EXAMPLE-BUCKET 1. s3://DOC-EXAMPLE-BUCKET/my-output-folder/ 1. s3://DOC-EXAMPLE-BUCKET/my-output-foldermy-call-analytics-job /.json ファイル名 (オプション 3) を指定しない限り、出力ファイルの名前には、`CallAnalyticsJobName`パラメーターを使用して文字起こしジョブに指定した名前と一致するデフォルト値が設定されます。 `OutputEncryptionKMSKeyId`パラメータを使用して KMS キーを指定して出力を暗号化できます。KMS キーを指定しない場合、Amazon Transcribe では、デフォルトの Amazon S3 キーが使用されます。 指定しない場合`OutputLocation`、トランスクリプトはサービス管理の Amazon S3 バケットに格納され、トランスクリプトにアクセスするための URI が提供されます。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 2,000 です。 パターン: `(s3://|http(s*)://).+` 必須: いいえ ** [Settings](#API_StartCallAnalyticsJob_RequestSyntax) ** [StartCallAnalyticsJob](#API_StartCallAnalyticsJob)リクエストには、コンテンツの編集など、その他のオプション設定を指定してください。これにより、カスタムの言語モデル、語彙フィルター、カスタムボキャブラリをコールアナリティクスのジョブに適用できます。 型: [CallAnalyticsJobSettings](API_CallAnalyticsJobSettings.md) オブジェクト 必須: いいえ ## レスポンスの構文 ``` { "CallAnalyticsJob": { "CallAnalyticsJobName": "string", "CallAnalyticsJobStatus": "string", "ChannelDefinitions": [ { "ChannelId": number, "ParticipantRole": "string" } ], "CompletionTime": number, "CreationTime": number, "DataAccessRoleArn": "string", "FailureReason": "string", "IdentifiedLanguageScore": number, "LanguageCode": "string", "Media": { "MediaFileUri": "string", "RedactedMediaFileUri": "string" }, "MediaFormat": "string", "MediaSampleRateHertz": number, "Settings": { "ContentRedaction": { "PiiEntityTypes": [ "string" ], "RedactionOutput": "string", "RedactionType": "string" }, "LanguageIdSettings": { "string" : { "LanguageModelName": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } }, "LanguageModelName": "string", "LanguageOptions": [ "string" ], "VocabularyFilterMethod": "string", "VocabularyFilterName": "string", "VocabularyName": "string" }, "StartTime": number, "Transcript": { "RedactedTranscriptFileUri": "string", "TranscriptFileUri": "string" } } } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [CallAnalyticsJob](#API_StartCallAnalyticsJob_ResponseSyntax) ** ジョブのステータス、該当する場合は失敗の理由など、現在の Call Analytics ジョブに関する詳細情報を提供します。 型: [CallAnalyticsJob](API_CallAnalyticsJob.md) オブジェクト ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** BadRequestException ** リクエストは 1 つ以上の検証テストに合格しませんでした。これは、削除しようとしているエンティティが存在しない場合、または非終端状態 (例:`IN PROGRESS`) の場合に発生します。詳細については、Message フィールドを参照してください。 HTTP ステータスコード: 400 ** ConflictException ** この名前のリソースは既に存在します。リソース名は内で固有である必要がありますAWS アカウント。 HTTP ステータスコード: 400 ** InternalFailureException ** インターナルエラーが発生しました。エラーメッセージを確認して、問題を修正して、リクエストを再試行してください。 HTTP ステータスコード: 500 ** LimitExceededException ** 送信されたコントロール リクエストを再試行する前に待つか、または小さなファイルを使用してリクエストを再試行してください。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/StartCallAnalyticsJob) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartCallAnalyticsJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/StartCallAnalyticsJob) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/StartCallAnalyticsJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/StartCallAnalyticsJob) + [AWSの SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/StartCallAnalyticsJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/StartCallAnalyticsJob) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/StartCallAnalyticsJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/StartCallAnalyticsJob)