기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

통화 분석 작업에 관한 세부 정보를 제공합니다.

작업 상태를 보려면 을 참조하십시오`CallAnalyticsJobStatus`. 상태인 경우 작업이 완료된 것입니다.`COMPLETED` 에 지정된 URI에서 완성된 성적표를 찾을 수`TranscriptFileUri` 있습니다. 상태인 경우 트랜스크립션 작업이 실패한 이유에 대한 세부 정보를`FailureReason` 제공합니다.`FAILED`

개인 식별 정보 (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>
지정된 통화 분석 작업의 상태를 제공합니다.  
상태인 경우 작업이 완료된 것이므로 에 지정된 위치`TranscriptFileUri` (또는`RedactedTranscriptFileUri` 트랜스크립트 수정을 요청한 경우) 에서 결과를 찾을 수 있습니다.`COMPLETED` 상태인 경우 트랜스크립션 작업이 실패한 이유에 대한 세부 정보를`FailureReason` 제공합니다.`FAILED`  
유형: String  
유효한 값:` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
Required: No

 ** ChannelDefinitions **   <a name="transcribe-Type-CallAnalyticsJob-ChannelDefinitions"></a>
어떤 스피커가 어느 채널에 있는지 나타냅니다.  
유형: [ChannelDefinition](API_ChannelDefinition.md) 객체 배열  
배열 멤버: 고정된 항목 수는 2개입니다.  
필수 항목 여부: 아니요

 ** CompletionTime **   <a name="transcribe-Type-CallAnalyticsJob-CompletionTime"></a>
지정된 Call Analytics 작업이 처리를 완료한 날짜 및 시간입니다.  
타임스탬프 형식은 다음과 같습니다`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) 입니다.  
유형: 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`인 경우 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\$148,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 사이의 값입니다. 값이 클수록 식별된 언어가 미디어에서 사용되는 언어와 정확하게 일치할 확률이 높습니다.  
유형: Float  
필수 항목 여부: 아니요

 ** 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`   
Required: No

 ** 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`   
Required: No

 ** MediaSampleRateHertz **   <a name="transcribe-Type-CallAnalyticsJob-MediaSampleRateHertz"></a>
입력 미디어 파일에 있는 오디오 트랙의 샘플 속도 (헤르츠) 입니다.  
유형: Integer  
유효한 범위: 최소값 8000입니다. 최대값은 48,000입니다.  
필수 항목 여부: 아니요

 ** Settings **   <a name="transcribe-Type-CallAnalyticsJob-Settings"></a>
요청에 포함된 추가 설정에 대한 정보를 제공합니다. 추가 설정에는 콘텐츠 수정 및 언어 식별 설정이 포함됩니다.  
유형: [CallAnalyticsJobSettings](API_CallAnalyticsJobSettings.md) 객체  
필수 항목 여부: 아니요

 ** StartTime **   <a name="transcribe-Type-CallAnalyticsJob-StartTime"></a>
지정된 Call Analytics 작업이 처리를 시작한 날짜 및 시간입니다.  
타임스탬프 형식은 다음과 같습니다`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>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [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)