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

# CallAnalyticsJob
<a name="API_CallAnalyticsJob"></a>

コール分析ジョブに関する詳細情報を提供します。

ジョブのステータスを表示するには、を参照してください`CallAnalyticsJobStatus`。ステータスが `COMPLETED` の場合、ジョブは終了しました。完成したトランスクリプトは、で指定された URI で確認できます`TranscriptFileUri`。ステータスがの場合`FAILED`、`FailureReason`文字起こしジョブが失敗した理由の詳細が表示されます。

個人情報 (PII) の編集を有効にすると、編集された文字起こしが、で指定した場所に表示されます`RedactedTranscriptFileUri`。

メディアファイル内のオーディオを編集することを選択した場合、`RedactedMediaFileUri`編集されたメディアファイルは回答欄で指定された場所にあります。

## 目次
<a name="API_CallAnalyticsJob_Contents"></a>

 ** CallAnalyticsJobName **   <a name="transcribe-Type-CallAnalyticsJob-CallAnalyticsJobName"></a>
コール分析ジョブの名前。Job 名は大文字と小文字が区別され、内で一意である必要がありますAWS アカウント。  
タイプ: 文字列  
長さの制限: 最小長は 1 です。最大長は 200 です。  
Pattern: `^[0-9a-zA-Z._-]+`   
必須: いいえ

 ** CallAnalyticsJobStatus **   <a name="transcribe-Type-CallAnalyticsJob-CallAnalyticsJobStatus"></a>
指定されたコール分析ジョブのステータスを提供します。  
ステータスがの場合`COMPLETED`、ジョブは終了し、で指定した場所で結果を確認できます`TranscriptFileUri` (または`RedactedTranscriptFileUri`、文字起こしをリクエストした場合)。ステータスがの場合`FAILED`、`FailureReason`文字起こしジョブが失敗した理由の詳細が表示されます。  
タイプ: 文字列  
有効な値: ` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
必須: いいえ

 ** ChannelDefinitions **   <a name="transcribe-Type-CallAnalyticsJob-ChannelDefinitions"></a>
どのスピーカーがどのチャンネルにあるかを示します。  
型: [ChannelDefinition](API_ChannelDefinition.md) オブジェクトの配列  
配列メンバー: 2 項目の定数。  
必須: いいえ

 ** CompletionTime **   <a name="transcribe-Type-CallAnalyticsJob-CompletionTime"></a>
指定されたコール分析ジョブが処理を終了した日付と時刻。  
`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`タイムスタンプは次の形式です。たとえば、`2022-05-04T12:33:13.922000-07:00`は、2022 年 5 月 4 日午後 12 時 33 分 (UTC) に処理を開始した文字起こしジョブを表します。  
型: タイムスタンプ  
分位数は、確率分布を等しい確率の領域に分割したものです。

 ** CreationTime **   <a name="transcribe-Type-CallAnalyticsJob-CreationTime"></a>
指定した Call Analytics ジョブリクエストが行われた日付と時刻。  
`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`タイムスタンプは次の形式です。たとえば、`2022-05-04T12:32:58.761000-07:00`は、2022 年 5 月 4 日午後 12 時 32 分 (UTC-7) に処理を開始した文字起こしジョブを表します。  
型: タイムスタンプ  
分位数は、確率分布を等しい確率の領域に分割したものです。

 ** DataAccessRoleArn **   <a name="transcribe-Type-CallAnalyticsJob-DataAccessRoleArn"></a>
リクエストに含めた Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制限: 最小長は 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}$`   
必須: いいえ

 ** FailureReason **   <a name="transcribe-Type-CallAnalyticsJob-FailureReason"></a>
`CallAnalyticsJobStatus`がの場合は`FAILED`、Call Analytics`FailureReason` ジョブリクエストが失敗した理由に関する情報が含まれます。  
`FailureReason` フィールドは、次のいずれかの値を含みます。  
+  `Unsupported media format`.

  `MediaFormat`で指定されたメディア形式は無効です。**MediaFormat**サポートされているフォーマットのリストについては、を参照してください。
+  `The media format provided does not match the detected media format`.

  で指定されたメディア形式は、`MediaFormat`入力ファイルの形式と一致しません。メディアファイルのメディアフォーマットを確認し、指定された値を修正してください。
+  `Invalid sample rate for audio file`.

  `MediaSampleRateHertz`で指定されたサンプルレートは無効です。サンプルレートは 8,000 から 48,000 ヘルツの間である必要があります。
+  `The sample rate provided does not match the detected sample rate`.

  で指定されたサンプルレートが、`MediaSampleRateHertz`入力メディアファイルで検出されたサンプルレートと一致しません。メディアファイルのサンプルレートを確認し、指定された値を修正してください。
+  `Invalid file size: file size too large`.

  メディアファイルのサイズは、Amazon Transcribe が処理できるサイズより大きいです。詳細については、「[ガイドラインとクォータ](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html#limits)」を参照してください。
+  `Invalid number of channels: number of channels too large`.

  音声には、Amazon Transcribe が処理できるよりも多くのチャネルが含まれています。詳細については、「[ガイドラインとクォータ](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html#limits)」を参照してください。
タイプ: 文字列  
必須: いいえ

 ** IdentifiedLanguageScore **   <a name="transcribe-Type-CallAnalyticsJob-IdentifiedLanguageScore"></a>
メディアファイルで識別された言語に関連する信頼度スコア。  
信頼度スコアは 0 から 1 までの値です。値が大きいほど、識別された言語がメディアで話されている言語と正しく一致する可能性が高いことを示します。  
タイプ: 浮動小数点  
必須: いいえ

 ** LanguageCode **   <a name="transcribe-Type-CallAnalyticsJob-LanguageCode"></a>
コール分析ジョブの作成に使用する言語コード。サポートされる言語とそれに関連する言語コードのリストについては、「[サポートされる言語](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html)」の表を参照してください。  
メディアファイルで話している言語が分からない場合は、このフィールドを省略すると、Amazon Transcribe がメディアの言語を自動的に識別します。言語識別の精度を上げるために、複数の言語コードを含めると、Amazon Transcribe が文字起こしに最も近い言語コードを選択します。  
タイプ: 文字列  
有効な値: ` af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE`   
必須: いいえ

 ** Media **   <a name="transcribe-Type-CallAnalyticsJob-Media"></a>
コール分析リクエストで使用したメディアファイルの Amazon S3 ロケーションを提供します。  
型: [Media](API_Media.md) オブジェクト  
必須: いいえ

 ** MediaFormat **   <a name="transcribe-Type-CallAnalyticsJob-MediaFormat"></a>
入力メディアファイルの形式。  
タイプ: 文字列  
有効な値: ` mp3 | mp4 | wav | flac | ogg | amr | webm`   
必須: いいえ

 ** MediaSampleRateHertz **   <a name="transcribe-Type-CallAnalyticsJob-MediaSampleRateHertz"></a>
入力メディアファイル内のオーディオトラックのサンプルレート (単位:ヘルツ)。  
型: 整数  
有効範囲: 最小値 は 8,000 です。48,000 の最大値。  
必須: いいえ

 ** Settings **   <a name="transcribe-Type-CallAnalyticsJob-Settings"></a>
リクエストに含まれていた追加設定に関する情報を提供します。その他の設定には、コンテンツ編集と言語識別設定が含まれます。  
型: [CallAnalyticsJobSettings](API_CallAnalyticsJobSettings.md) オブジェクト  
必須: いいえ

 ** StartTime **   <a name="transcribe-Type-CallAnalyticsJob-StartTime"></a>
指定されたコール分析ジョブが処理を開始した日付と時刻。  
`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`タイムスタンプは次の形式です。たとえば、`2022-05-04T12:32:58.789000-07:00`は、2022 年 5 月 4 日午後 12 時 32 分 (UTC-7) に処理を開始した文字起こしジョブを表します。  
型: タイムスタンプ  
分位数は、確率分布を等しい確率の領域に分割したものです。

 ** Transcript **   <a name="transcribe-Type-CallAnalyticsJob-Transcript"></a>
文字起こしへのアクセスに使用できる Amazon S3 URI を提供します。  
型: [Transcript](API_Transcript.md) オブジェクト  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_CallAnalyticsJob_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CallAnalyticsJob) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CallAnalyticsJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CallAnalyticsJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CallAnalyticsJob)