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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要上传评估音频的评估的资源名称。格式:projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "audioContent": string,
  "previousAudioGcsUri": string
}
字段
audioContent

string (bytes format)

必需。原始音频字节。音频的格式必须为单声道 LINEAR16,采样率为 16kHz(默认 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)

音频时长。

该时长以秒为单位,最多包含九个小数位,以“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 文档