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 Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。評価音声をアップロードする評価のリソース名。形式: projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "audioContent": string,
  "previousAudioGcsUri": string
}
フィールド
audioContent

string (bytes format)

必須。未加工の音声バイト。音声の形式は、サンプリング レートが 16 kHz のシングル チャンネル 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)

音声の長さ。

s で終わる小数 9 桁までの秒単位の期間。例: "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 のドキュメントをご覧ください。