Method: projects.locations.apps.evaluations.uploadEvaluationAudio

골든 평가에 사용할 오디오를 업로드합니다. 'App.logging_settings.evaluation_audio_recording_config.gcs_bucket'에 정의된 Cloud Storage 버킷에 오디오를 저장하고 스크립트를 반환합니다.

HTTP 요청

POST https://ces.googleapis.com/v1beta/{name=projects/*/locations/*/apps/*/evaluations/*}:uploadEvaluationAudio

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 평가 오디오를 업로드할 평가의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "audioContent": string,
  "previousAudioGcsUri": string
}
필드
audioContent

string (bytes format)

필수 항목입니다. 원시 오디오 바이트입니다. 오디오 형식은 샘플링 레이트가 16kHz인 단일 채널 LINEAR16이어야 합니다 (기본 InputAudioConfig).

base64 인코딩 문자열입니다.

previousAudioGcsUri

string

선택사항입니다. 삭제할 이전에 업로드된 오디오 파일의 Google Cloud Storage URI입니다. 형식: gs://<bucket-name>/<object-name>

응답 본문

EvaluationService.UploadEvaluationAudio의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "audioGcsUri": string,
  "transcript": string,
  "duration": string
}
필드
audioGcsUri

string

업로드된 오디오 파일이 저장된 Google Cloud Storage URI입니다. 형식: gs://<bucket-name>/<object-name>

transcript

string

Cloud Speech-to-Text에서 생성된 오디오 스크립트입니다.

duration

string (Duration format)

오디오 길이입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

자세한 내용은 Authentication Overview에서 확인하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • ces.evaluations.update

자세한 내용은 IAM 문서를 참조하세요.