Method: projects.locations.apps.evaluations.uploadEvaluationAudio

Faz upload de áudio para uso em avaliações de ouro. Armazena o áudio no bucket do Cloud Storage definido em "App.logging_settings.evaluation_audio_recording_config.gcs_bucket" e retorna uma transcrição.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso da avaliação para fazer upload do áudio. Formato: projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "audioContent": string,
  "previousAudioGcsUri": string
}
Campos
audioContent

string (bytes format)

Obrigatório. Os bytes de áudio brutos. O formato do áudio precisa ser LINEAR16 de canal único com uma taxa de amostragem de 16 kHz (InputAudioConfig padrão).

Uma string codificada em base64.

previousAudioGcsUri

string

Opcional. O URI do Google Cloud Storage do arquivo de áudio enviado anteriormente que será excluído. Formato: gs://<bucket-name>/<object-name>

Corpo da resposta

Mensagem de resposta para EvaluationService.UploadEvaluationAudio.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "audioGcsUri": string,
  "transcript": string,
  "duration": string
}
Campos
audioGcsUri

string

O URI do Google Cloud Storage em que o arquivo de áudio enviado é armazenado. Formato: gs://<bucket-name>/<object-name>

transcript

string

A transcrição do áudio, gerada pela Cloud Speech-to-Text.

duration

string (Duration format)

A duração do áudio.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • ces.evaluations.update

Para mais informações, consulte a documentação do IAM.