Administra el resumen de audio de tu notebook (API)

Después de crear tu notebook y agregarle fuentes de datos, puedes generar de forma programática un resumen de audio del notebook. En un momento dado, un notebook determinado solo puede tener un resumen de audio. En esta página, se describe cómo crear y borrar resúmenes de audio.

Diferencia entre un resumen de audio y un podcast

Los resúmenes de audio se diferencian de los podcasts de las siguientes maneras:

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

Crear un resumen de audio

Para generar un resumen de audio del contenido de tu notebook, llama al método notebooks.audioOverviews.create. Como solo puedes tener un resumen de audio por notebook, este método solo se ejecuta correctamente si el notebook no tiene un resumen de audio existente.

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"
  }

Reemplaza lo siguiente:

  • ENDPOINT_LOCATION: Es la región múltiple para 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 Cómo especificar una región múltiple para tu almacén de datos.
  • PROJECT_NUMBER: Es 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: Es el identificador único del notebook.
  • SOURCE_ID: Es el ID de la fuente en función de la cual deseas generar el resumen de audio. sourceIdsfield es un array opcional. Si no especificas ningún ID de fuente, se usarán todas las fuentes del notebook. Para obtener información sobre el ID de la fuente, consulta Cómo agregar y administrar fuentes de datos en un notebook (API).
  • EPISODE_FOCUS: Es una cadena que describe qué temas o contenido se deben destacar en el resumen de audio.
  • LANGUAGE_CODE: Es el código de idioma en el que se solicitó el resumen de audio.

Si la solicitud se realiza correctamente, deberías recibir 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"
    }
  }

La generación de un resumen de audio tarda unos minutos.

Cómo verificar un resumen de audio generado

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

  1. Abre tu notebook. Para obtener más información, consulta Cómo acceder al notebook creado.

  2. En Studio de tu notebook, haz clic en Cargar para cargar la conversación. La carga de la descripción general tarda unos instantes.

    En el estudio, puedes administrar el resumen de audio con tareas como cambiar la velocidad de reproducción y descargar o borrar el archivo del resumen de audio.

Cómo borrar un resumen de audio

Para borrar un resumen de audio existente, 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" \

Reemplaza lo siguiente:

  • ENDPOINT_LOCATION: Es la región múltiple para 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 Cómo especificar una región múltiple para tu almacén de datos.
  • PROJECT_NUMBER: Es 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: Es el identificador único del notebook.

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