Method: projects.locations.apps.evaluations.uploadEvaluationAudio

上傳音訊,用於黃金評估。將音訊儲存在「App.logging_settings.evaluation_audio_recording_config.gcs_bucket」中定義的 Cloud Storage bucket,並傳回轉錄稿。

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)

音訊長度。

時間長度以秒為單位,最多可有 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 說明文件