本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 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 名称区分大小写，在 a中必须是唯一的AWS 账户。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 200。  
模式：`^[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) 对象数组  
数组成员：固定数量为 15 项。  
必需：否

 ** 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 日 UTC-7 下午 12:33 开始处理的转录作业。  
类型：Timestamp  
必需：否

 ** 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 日 UTC-7 下午 12:32 开始处理的转录作业。  
类型：Timestamp  
必需：否

 ** DataAccessRoleArn **   <a name="transcribe-Type-CallAnalyticsJob-DataAccessRoleArn"></a>
您在请求中包含的 Amazon 资源名称（ARN）。  
类型：字符串  
长度限制：最小长度为 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`包含有关 Call Analytics 任务请求失败原因的信息。  
该`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>
输入媒体文件中音轨的采样率，以赫兹为单位。  
类型：整数  
有效范围：最小值为 8000。最大值为 48000。  
必需：否

 ** 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 日 UTC-7 下午 12:32 开始处理的转录作业。  
类型：Timestamp  
必需：否

 ** Transcript **   <a name="transcribe-Type-CallAnalyticsJob-Transcript"></a>
为您提供您可用来访问 Amazon S3 的 URI。  
类型：[Transcript](API_Transcript.md) 对象  
必需：否

## 另请参阅
<a name="API_CallAnalyticsJob_SeeAlso"></a>

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CallAnalyticsJob) 
+  [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CallAnalyticsJob) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CallAnalyticsJob) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CallAnalyticsJob)