Method: projects.locations.apps.evaluations.uploadEvaluationAudio

Sube audio para usarlo en las evaluaciones de referencia. Almacena el audio en el bucket de Cloud Storage definido en "App.logging_settings.evaluation_audio_recording_config.gcs_bucket" y devuelve una transcripción.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Es el nombre del recurso de la evaluación para la que se subirá el audio de la evaluación. Formato: projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "audioContent": string,
  "previousAudioGcsUri": string
}
Campos
audioContent

string (bytes format)

Obligatorio. Son los bytes de audio sin procesar. El formato del audio debe ser LINEAR16 de un solo canal con una frecuencia de muestreo de 16 kHz (InputAudioConfig predeterminado).

Es una cadena codificada en Base64.
previousAudioGcsUri

string

Es opcional. Es el URI de Google Cloud Storage del archivo de audio que se subió anteriormente y que se borrará. Formato: gs://<bucket-name>/<object-name>

Cuerpo de la respuesta

Mensaje de respuesta para EvaluationService.UploadEvaluationAudio.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "audioGcsUri": string,
  "transcript": string,
  "duration": string
}
Campos
audioGcsUri

string

Es el URI de Google Cloud Storage en el que se almacena el archivo de audio subido. Formato: gs://<bucket-name>/<object-name>
transcript

string

Es la transcripción del audio, generada por Cloud Speech-to-Text.
duration

string (Duration format)

Es la duración del audio.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • ces.evaluations.update

Para obtener más información, consulta la documentación de IAM.