Gestionar el resumen de audio de un cuaderno (API)

Después de crear un cuaderno y añadirle fuentes de datos, puedes generar de forma programática un resumen de audio del cuaderno. Un cuaderno solo puede tener un resumen de audio a la vez. En esta página se describe cómo crear y eliminar resúmenes de audio.

Diferencia entre un resumen de audio y un pódcast

Un resumen de audio se diferencia de un pódcast en los siguientes aspectos:

• Un resumen de audio debe estar asociado a un cuaderno al que se le hayan añadido fuentes de datos. Por otro lado, se puede generar un pódcast sin un cuaderno de NotebookLM Enterprise, una licencia de Gemini Enterprise o un almacén de datos. Para crear un pódcast, solo necesitas un proyecto habilitado y el rol de usuario de la API Podcast. Google Cloud
• Para crear un resumen de audio, llama al método notebooks.audioOverview. Para crear un pódcast, llama al método podcasts, una API independiente.

Crear resumen de audio

Para generar un resumen de audio del contenido de tu cuaderno, llama al método notebooks.audioOverviews.create. Como solo puedes tener un resumen de audio por cuaderno, este método solo funciona si el cuaderno no tiene ningún resumen de audio.

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews" \
  -d '{
  "sourceIds": [
    {
      "id": "SOURCE_ID"
    }
  ],
  "episodeFocus": "EPISODE_FOCUS",
  "languageCode": "LANGUAGE_CODE"
  }

Haz los cambios siguientes:

• ENDPOINT_LOCATION: la multirregión de tu solicitud a la API. Asigna uno de los siguientes valores:
  • us- para la multirregión de EE. UU.
  • eu- para la multirregión de la UE
  • global- para la ubicación global
  Para obtener más información, consulta el artículo sobre cómo especificar una multirregión para tu almacén de datos.
• PROJECT_NUMBER: el número de tu proyecto de Google Cloud .
• LOCATION: la ubicación geográfica de tu almacén de datos, como global. Para obtener más información, consulta Ubicaciones.
• NOTEBOOK_ID: identificador único del cuaderno.
• SOURCE_ID: el ID de la fuente en la que se basa la función para generar el resumen de audio. El sourceIdsfield es un array opcional. Si no especificas ningún ID de fuente, se usarán todas las fuentes del cuaderno. Para obtener información sobre el ID de origen, consulta el artículo Añadir y gestionar fuentes de datos en un cuaderno (API).
• EPISODE_FOCUS: cadena que describe los temas o el contenido que se deben destacar en el resumen de audio.
• LANGUAGE_CODE: el código de idioma en el que se solicitó el resumen de audio.

Si la solicitud se realiza correctamente, deberías obtener una respuesta JSON similar a la siguiente. Esta respuesta muestra que la generación del resumen de audio está en curso.

  {
    "audioOverview": {
      "status": "AUDIO_OVERVIEW_STATUS_IN_PROGRESS",
      "audioOverviewId": "AUDIO_OVERVIEW_ID",
      "generationOptions": {},
      "name": "AUDIO_OVERVIEW_NAME"
    }
  }

Se tarda unos minutos en generar un resumen de audio.

Verificar un resumen de audio generado

Para verificar el resumen de audio generado, haz lo siguiente:

1. Abre tu cuaderno. Para obtener más información, consulta Acceder al cuaderno creado.

2. En el Studio de tu cuaderno, haz clic en Cargar para cargar la conversación. El resumen tarda unos instantes en cargarse.

   En Studio, puedes gestionar tu resumen de audio con tareas como cambiar la velocidad de reproducción y descargar o eliminar el archivo del resumen de audio.

Eliminar un resumen de audio

Para eliminar un resumen de audio, llama al método notebooks.audioOverviews.delete.

REST

curl -X DELETE \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews/default" \

Haz los cambios siguientes:

• ENDPOINT_LOCATION: la multirregión de tu solicitud a la API. Asigna uno de los siguientes valores:
  • us- para la multirregión de EE. UU.
  • eu- para la multirregión de la UE
  • global- para la ubicación global
  Para obtener más información, consulta el artículo sobre cómo especificar una multirregión para tu almacén de datos.
• PROJECT_NUMBER: el número de tu proyecto de Google Cloud .
• LOCATION: la ubicación geográfica de tu almacén de datos, como global. Para obtener más información, consulta Ubicaciones.
• NOTEBOOK_ID: identificador único del cuaderno.

Si la solicitud se realiza correctamente, deberías recibir un JSON vacío.