本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 帳戶.  
類型：String  
長度限制：長度下限為 1。長度上限為 200。  
模式：`^[0-9a-zA-Z._-]+`  
必要：否

 ** CallAnalyticsJobStatus **   <a name="transcribe-Type-CallAnalyticsJob-CallAnalyticsJobStatus"></a>
提供指定呼叫分析工作的狀態。  
如果狀態為`COMPLETED`，表示工作已完成，您可以在`TranscriptFileUri` (如果您要求成績單密文) 中指定的位置找到結果。`RedactedTranscriptFileUri`如果狀態為`FAILED`，則`FailureReason`提供轉錄工作失敗原因的詳細資訊。  
類型：String  
有效值：` 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-7 開始處理的轉錄工作。  
類型：Timestamp  
必要：否

 ** CreationTime **   <a name="transcribe-Type-CallAnalyticsJob-CreationTime"></a>
提出指定呼叫分析工作要求的日期和時間。  
時間戳記的格式為`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`。例如，`2022-05-04T12:32:58.761000-07:00`代表在 2022 年 5 月 4 日下午 12 時 32 分 UTC-7 開始處理的轉錄工作。  
類型：Timestamp  
必要：否

 ** DataAccessRoleArn **   <a name="transcribe-Type-CallAnalyticsJob-DataAccessRoleArn"></a>
您在請求中包含的 Amazon Resource Name (ARN)。  
類型：String  
長度限制︰長度下限為 20。長度上限為 2048。  
模式：`^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`，則`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 會選擇最接近您轉錄的相符項目。  
類型：String  
有效值：` 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>
輸入媒體檔案的格式。  
類型：String  
有效值：` mp3 | mp4 | wav | flac | ogg | amr | webm`  
必要：否

 ** MediaSampleRateHertz **   <a name="transcribe-Type-CallAnalyticsJob-MediaSampleRateHertz"></a>
輸入媒體檔案中音軌的取樣率 (以赫茲為單位)。  
類型：整數  
有效範圍：最小值為此介面來存取 V。最大值為此介面來存取 V。  
必要：否

 ** 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 開始處理的轉錄工作。  
類型：Timestamp  
必要：否

 ** Transcript **   <a name="transcribe-Type-CallAnalyticsJob-Transcript"></a>
提供您可以用來存取 VAP 的 Amazon S3 URI。  
類型：[Transcript](API_Transcript.md) 物件  
必要：否

## 另請參閱
<a name="API_CallAnalyticsJob_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CallAnalyticsJob) 
+  [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CallAnalyticsJob) 
+  [適用於 Java 的 AWS 開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CallAnalyticsJob) 
+  [適用於 Ruby 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CallAnalyticsJob)