Especifica el esquema para los registros de Gemini Notebook en BigQuery

Cuando cargas datos en una tabla o creas una tabla vacía en BigQuery, debes especificar un esquema. En esta página, se describen el esquema de la tabla y las consultas de ejemplo para los informes comunes que puedes obtener de BigQuery.

Acerca de la tabla de actividad

Puedes revisar los eventos de registro de Gemini Notebook en la tabla de actividad. Puedes encontrar lo siguiente:

  • Contenedor de notebook en los campos de recursos principales estándar de Google Workspace, como resource_ids y resource_details. Usa estos campos para hacer un seguimiento del ID, el título, el tipo, el propietario y la URL web del notebook.
  • Parámetros específicos del evento, como el material de referencia y los detalles del artefacto de Studio, anidados en el registro gemini_notebook

Acerca de los campos de recursos principales

En la siguiente tabla, se definen los campos de recursos principales en la tabla activity que identifican y describen el notebook.

Nombre del campo Tipo Modo Descripción
resource_ids CADENA REPEATED Es un array que contiene el identificador único (UUID) del notebook.
resource_details RECORD REPEATED Detalles sobre el notebook asociado con el evento de registro
resource_details.id CADENA NULLABLE Es el UUID del cuaderno. Corresponde al ID del cuaderno en la URL web: https://notebook.google.com/notebook/id
resource_details.title CADENA NULLABLE Nombre visible o título del notebook
resource_details.type CADENA NULLABLE Categoría de tipo de recurso para el cuaderno (GEMINI_NOTEBOOK_NOTEBOOK)
resource_details.owner_details.owner_identity.user_identity.user_email CADENA NULLABLE Dirección de correo electrónico del propietario del notebook

Tabla de plantillas para Gemini Notebook

En la siguiente tabla de plantillas, se definen y describen los campos específicos del evento anidados dentro del registro gemini_notebook en la tabla activity. Los componentes del esquema de esta página se actualizan ocasionalmente. Cuando se agregan campos nuevos, la siguiente tabla diaria que se genera a partir de la plantilla tiene los campos nuevos. Si deseas consultar campos nuevos, consulta las tablas diarias generadas después de que se actualice la plantilla.

Aprende a especificar y modificar esquemas en BigQuery.

Nombre del campo Tipo Modo Descripción
ai_plan_tier ENUM NULLABLE Es el nivel de suscripción a la IA generativa del usuario en el momento en que se produjo el evento. Valores posibles:
  • AI Expanded
  • Plus
  • Pro
  • Standard
  • Ultra
prior_visibility ENUM NULLABLE Visibilidad del cuaderno antes del evento Valores posibles:
  • anyone_with_link
  • privado
  • público
  • shared_internally
destinatario CADENA NULLABLE Es el usuario o grupo cuyo acceso se modificó en el evento.
recipient_access_type ENUM NULLABLE Es el tipo de acceso que se otorga o quita al destinatario. Valores posibles:
  • ver
  • editar
  • quitar
source_id CADENA NULLABLE Es el identificador único del material de referencia al que se hace referencia en el Notebook.
source_name CADENA NULLABLE Es el nombre visible del material de referencia al que se hace referencia en el Notebook.
source_type ENUM NULLABLE Tipo de datos de la fuente. Valores posibles:
  • copied_text
  • drive
  • local_upload
  • url
source_url CADENA NULLABLE Es la URL de la fuente.
studio_artifact_id CADENA NULLABLE Es el identificador único del artefacto de Studio generado.
studio_artifact_name CADENA NULLABLE Es el nombre visible del artefacto de Studio.
studio_artifact_type ENUM NULLABLE Es el tipo de datos del artefacto de Studio. Valores posibles:
  • audio_overview
  • data_table
  • tarjetas
  • infographic
  • mind_map
  • cuestionario
  • report
  • slide_deck
  • video_overview
visibilidad ENUM NULLABLE Visibilidad del notebook después del evento. Valores posibles:
  • anyone_with_link
  • privado
  • público
  • shared_externally
  • shared_externally_trusted_domain
  • shared_internally

En este ejemplo, se usa SQL estándar. Reemplaza project-id.dataset-id por el ID de tu proyecto y el nombre del conjunto de datos. La consulta devuelve el identificador único, el título, el tipo de recurso, la dirección de correo electrónico del propietario, la cantidad total de fuentes agregadas y los artefactos de Studio generados, y la URL directa de cada notebook.

-- List notebooks with owner, activity counts, and direct web URLs
SELECT
  resource_details[SAFE_OFFSET(0)].id AS notebook_id,
  ANY_VALUE(resource_details[SAFE_OFFSET(0)].title) AS notebook_title,
  ANY_VALUE(resource_details[SAFE_OFFSET(0)].type) AS resource_type,
  ANY_VALUE(resource_details[SAFE_OFFSET(0)].owner_details.owner_identity[SAFE_OFFSET(0)].user_identity.user_email) AS owner_email,
  COUNTIF(event_name = 'add_source') AS total_sources,
  COUNTIF(event_name = 'generate_studio_artifact') AS total_artifacts,
  ANY_VALUE(CONCAT('https://notebook.google.com/notebook/', resource_details[SAFE_OFFSET(0)].id)) AS notebook_url
FROM `project-id.dataset-id.activity`
WHERE gemini_notebook IS NOT NULL
GROUP BY notebook_id;