CallAnalyticsJob

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

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

개인 식별 정보 (PII) 수정을 활성화한 경우 수정된 사본이 에 지정된 위치에 나타납니다RedactedTranscriptFileUri.

미디어 파일의 오디오를 편집하기로 선택한 경우 응답RedactedMediaFileUri 필드에 지정된 위치에서 편집된 미디어 파일을 찾을 수 있습니다.

상태인 경우 작업이 완료된 것이므로 에 지정된 위치TranscriptFileUri (또는RedactedTranscriptFileUri 트랜스크립트 수정을 요청한 경우) 에서 결과를 찾을 수 있습니다.COMPLETED 상태인 경우 트랜스크립션 작업이 실패한 이유에 대한 세부 정보를FailureReason 제공합니다.FAILED

유형: String

유효한 값: QUEUED | IN_PROGRESS | FAILED | COMPLETED

Required: No

ChannelDefinitions

어떤 스피커가 어느 채널에 있는지 나타냅니다.

유형: ChannelDefinition 객체 배열

배열 멤버: 고정된 항목 수는 2개입니다.

필수 항목 여부: 아니요

CompletionTime

지정된 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

지정된 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

요청에 포함하신 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

CallAnalyticsJobStatusFAILED인 경우 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에서 처리할 수 있는 크기보다 큽니다. 자세한 내용은 가이드라인 및 할당량을 참조하십시오.
Invalid number of channels: number of channels too large.

오디오에는 Amazon Transcribe에서 처리할 수 있는 것보다 더 많은 채널이 포함되어 있습니다. 자세한 내용은 가이드라인 및 할당량을 참조하십시오.

유형: 문자열

필수 항목 여부: 아니요

IdentifiedLanguageScore

미디어 파일에서 식별된 언어와 관련된 신뢰도 점수입니다.

신뢰도 점수는 0과 1 사이의 값입니다. 값이 클수록 식별된 언어가 미디어에서 사용되는 언어와 정확하게 일치할 확률이 높습니다.

유형: Float

필수 항목 여부: 아니요

LanguageCode

통화 분석 작업을 만드는 데 사용되는 언어 코드입니다. 지원되는 언어 및 관련 언어 코드 목록은 지원되는 언어 표를 참조하십시오.

미디어 파일에서 사용되는 언어를 모르는 경우 이 필드를 생략하고 Amazon Transcribe에서 미디어의 언어를 자동으로 식별하도록 할 수 있습니다. 언어 식별의 정확도를 높이기 위해 여러 언어 코드를 포함하면 Amazon Transcribe가 트랜스크립션과 가장 일치하는 코드를 선택합니다.

유형: String

Required: No

Media

통화 분석 요청에 사용한 미디어 파일의 Amazon S3 위치를 제공합니다.

유형: Media 객체

필수 항목 여부: 아니요

MediaFormat

입력 미디어 파일의 형식입니다.

유형: String

유효한 값: mp3 | mp4 | wav | flac | ogg | amr | webm

Required: No

MediaSampleRateHertz

입력 미디어 파일에 있는 오디오 트랙의 샘플 속도 (헤르츠) 입니다.

유형: Integer

유효한 범위: 최소값 8000입니다. 최대값은 48,000입니다.

필수 항목 여부: 아니요

Settings

요청에 포함된 추가 설정에 대한 정보를 제공합니다. 추가 설정에는 콘텐츠 수정 및 언어 식별 설정이 포함됩니다.

유형: CallAnalyticsJobSettings 객체

필수 항목 여부: 아니요

StartTime

지정된 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

트랜스크립트에 액세스할 때 사용할 수 있는 Amazon S3 URI를 제공합니다.

유형: Transcript 객체

필수 항목 여부: 아니요

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AbsoluteTimeRange

CallAnalyticsJobSettings

CallAnalyticsJob

목차

참고 항목