Herramientasnotebooklm api
NotebookLM API: acceso oficial y primeros pasos
Descubre qué permite la API de NotebookLM Enterprise, sus requisitos y cómo crear un cuaderno con datos de prueba sin confundirla con la app personal.
- Autor: humAIns
- 8 min de lectura
índice · 8 apartados
Sí, existe una API oficial para la edición empresarial de NotebookLM, que Google denomina Gemini Notebook Enterprise: su documentación REST v1alpha permite crear cuadernos y añadir fuentes. No es la API de la aplicación personal: antes de probarla necesitas configurar el producto empresarial, una licencia asignada y el rol de Google Cloud correspondiente. Aquí tienes el alcance documentado y un recorrido reproducible con identificadores ficticios, sin exponer credenciales ni asumir acceso universal.
App personal y API empresarial: no son lo mismo
Google anunció el cambio de nombre de NotebookLM a Gemini Notebook el 16 de julio de 2026. Algunas páginas y rutas conservan NotebookLM, y la oferta empresarial aparece en la documentación como Gemini Notebook Enterprise (antes NotebookLM Enterprise). Por eso puedes encontrar ambos nombres en documentación y referencias API. El artículo general NotebookLM y Gemini Notebook: fuentes y plan gratis explica la experiencia de uso; esta guía se limita al acceso programático y sus requisitos.
Las páginas oficiales «Create and manage notebooks (API)» y «Add and manage data sources in a notebook (API)», consultadas el 14 de noviembre de 2026, identifican el producto empresarial y muestran recursos v1alpha. Esa marca es importante: se trata de una superficie documentada como alpha; no debe presentarse como una interfaz estable o disponible para todas las cuentas. Las operaciones incluyen crear, recuperar, listar cuadernos vistos recientemente, compartir y borrar cuadernos, además de crear en lote, subir, recuperar y borrar fuentes.
La documentación no afirma que una cuenta personal obtenga estos endpoints. Tampoco hay que confundir la API de Gemini Notebook Enterprise con la API de Gemini para generar texto: son productos y recursos distintos. Si tu organización no tiene acceso empresarial, la existencia de estos métodos no habilita una API en tu cuaderno personal.
Requisitos antes de hacer una petición
La guía de Google indica estos pasos previos:
- Configurar Gemini Notebook Enterprise en la organización.
- Obtener licencias del producto y asignar una a la cuenta de usuario que hará las solicitudes.
- Conceder a esa cuenta el rol Cloud NotebookLM User, cuyo identificador es
roles/discoveryengine.notebookLmUser. - Iniciar sesión en Google Cloud CLI con las credenciales de usuario mediante
gcloud auth login.
La página especifica que los métodos REST requieren una cuenta de usuario autenticada con licencia activa de Gemini Notebook Enterprise. Por tanto, no sustituyas este flujo por una clave API inventada ni presupongas que una cuenta de servicio tiene el mismo acceso. Sigue la configuración y los permisos vigentes de tu organización, especialmente si la automatización debe ejecutarse sin una persona presente.
Para usar fuentes de Google Drive (Docs o Slides), la guía de fuentes añade un requisito concreto: iniciar sesión con acceso a Drive mediante gcloud auth login --enable-gdrive-access. Esto autoriza el acceso a esas fuentes; no elimina los requisitos del producto y de la licencia.
Crear un cuaderno de prueba
La operación documentada es notebooks.create, con una petición POST al recurso de cuadernos. Este ejemplo sigue el patrón de Google y usa marcadores, no credenciales ni identificadores válidos. Reemplaza ENDPOINT_LOCATION, PROJECT_NUMBER y LOCATION solo en un proyecto de prueba autorizado:
curl -X POST \\
-H "Authorization: Bearer $(gcloud auth print-access-token)" \\
-H "Content-Type: application/json" \\
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks" \\
-d '{"title":"Prueba API - datos ficticios"}'
En la respuesta, Google muestra notebookId como identificador corto y name como nombre de recurso completo, con patrón projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID. Conserva el valor devuelto para la siguiente petición; no inventes el ID ni incluyas información sensible en el título. Para ejemplos posteriores, PROJECT_NUMBER=123456789012, LOCATION=global y NOTEBOOK_ID=notebook-demo-001 son únicamente marcadores ilustrativos: no representan un recurso real.
ENDPOINT_LOCATION y LOCATION cumplen funciones distintas. La documentación enumera us, eu y global como valores de endpoint para las llamadas de ejemplo y describe LOCATION como la ubicación geográfica del almacén de datos, por ejemplo global. No elijas una región por intuición: confirma la ubicación de tu suscripción y almacén de datos con el administrador y la documentación de ubicaciones. Para una suscripción en la multirregión US, Google documenta el host discoveryengine.us.rep.googleapis.com y el valor us; explica también que este endpoint procesa y termina TLS dentro de US, pero no cambia la ubicación donde se almacenan los cuadernos. No extrapoles esa excepción a otras ubicaciones.
Añadir una fuente con contenido de prueba
Para añadir contenido en lote, la operación oficial es notebooks.sources.batchCreate. Por ejemplo, con texto deliberadamente ficticio, la estructura de la solicitud es:
curl -X POST \\
-H "Authorization: Bearer $(gcloud auth print-access-token)" \\
-H "Content-Type: application/json" \\
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/sources:batchCreate" \\
-d '{"userContents":[{"textContent":{"sourceName":"Nota de prueba","content":"Este documento es un ejemplo ficticio para comprobar la integración."}}]}'
El cuerpo admite una fuente por elemento: la página documenta Google Drive (Docs y Slides), texto sin procesar, contenido web y vídeos de YouTube. En Drive hay que indicar documentId, mimeType y sourceName; los MIME types especificados para Docs y Slides son application/vnd.google-apps.document y application/vnd.google-apps.presentation. Para texto se usan sourceName y content; para web, url y sourceName; para vídeo, youtubeUrl.
Google también documenta notebooks.sources.uploadFile para cargar un archivo individual. Entre los tipos admitidos figuran PDF, TXT, Markdown, DOCX, PPTX y XLSX; la página enumera además audio, vídeo e imágenes con sus tipos de contenido. Comprueba la lista oficial antes de integrar formatos menos habituales. Una respuesta puede devolver sourceId y, en una creación en lote, un nombre de recurso; guárdalos si vas a consultar o borrar esa fuente después.
La API no convierte una URL de Drive en permiso de lectura: el usuario debe poder acceder al documento. Para datos corporativos, prueba primero con material sintético y valida propietario, clasificación, región, retención y permisos antes de enviar documentos reales. La guía del endpoint multirregional US se refiere a la ruta de los datos en tránsito; explícitamente no cambia el lugar de almacenamiento.
Credenciales, costes y protección de datos
El comando gcloud auth print-access-token del ejemplo obtiene un token temporal de la sesión autenticada. No lo copies en código fuente, tickets, registros compartidos ni ejemplos públicos. Evita guardar tokens en repositorios o dejar que aparezcan en logs de CI; utiliza el mecanismo aprobado por el equipo de seguridad para ejecutar automatizaciones y renovar credenciales.
Las dos guías de API citadas describen operaciones y requisitos, pero no establecen en esas páginas un precio por llamada ni un coste total de licencia. No calcules el coste de despliegue a partir de la existencia de una API: consulta los términos y precios aplicables a tu contrato empresarial con Google. Antes de una prueba real, acuerda con el responsable de datos qué contenido puede salir del entorno y quién tiene acceso al cuaderno.
Para profundizar en criterios de uso seguro, consulta Privacidad de la IA en el trabajo. Si buscas orquestar tareas entre aplicaciones, qué es n8n aborda automatizaciones desde otro ángulo; no es un requisito ni un sustituto de esta API.
Si solo tienes la app personal
Si no ves una interfaz de API en Gemini Notebook personal, no intentes acceder con rutas empresariales ni reutilices credenciales de otra persona. Confirma con el administrador si la organización tiene Gemini Notebook Enterprise, si tu usuario dispone de licencia y rol, y si la ubicación elegida está habilitada. Si no tienes esa edición, puedes seguir usando la aplicación según sus funciones disponibles, o evaluar por separado una API de modelos y una solución de búsqueda documental que tu organización haya aprobado. Ninguna de esas alternativas es la API de NotebookLM Enterprise.
La formación de IA aplicada al sector audiovisual puede ser útil para aprender a trabajar con fuentes audiovisuales, pero no enseña esta API empresarial. Para identificar qué conocimientos de IA necesitas en tu caso, prueba el diagnóstico gratuito.
Preguntas frecuentes
¿Existe una API oficial de NotebookLM?
Sí, Google documenta una API REST v1alpha para Gemini Notebook Enterprise, nombre actual del producto empresarial que antes se llamaba NotebookLM Enterprise. La documentación consultada lista operaciones de cuadernos y fuentes. No implica que la aplicación personal tenga la misma API.
¿Funciona con la cuenta personal?
Las páginas consultadas especifican la edición Enterprise, una licencia activa y autenticación de usuario. No documentan el uso de estos endpoints con la cuenta personal de Gemini Notebook. Comprueba el acceso con el administrador de tu organización.
¿Qué permisos hacen falta?
Se requiere una licencia de Gemini Notebook Enterprise asignada a tu usuario y el rol Cloud NotebookLM User (roles/discoveryengine.notebookLmUser). Para fuentes de Drive, Google indica iniciar sesión con gcloud auth login --enable-gdrive-access.
¿Se pueden añadir fuentes mediante API?
Sí. notebooks.sources.batchCreate admite fuentes de Google Docs, Google Slides, texto, web y YouTube; notebooks.sources.uploadFile cubre archivos compatibles. Revisa los formatos y permisos en la documentación oficial antes de automatizar una carga.
Documentación oficial
- Create and manage notebooks (API) — Gemini Notebook Enterprise (actualizada el 11 de noviembre de 2026).
- Add and manage data sources in a notebook (API) — Gemini Notebook Enterprise (actualizada el 10 de noviembre de 2026).