Как указать схему для журналов Gemini Notebook в BigQuery

При загрузке данных в таблицу или создании пустой таблицы в BigQuery необходимо указать схему. На этой странице вы найдете схему таблицы и примеры запросов для создания отчетов в BigQuery.

Таблица действий

События журнала Gemini Notebook можно посмотреть в таблице действий. Вы можете найти:

  • Контейнер блокнота в стандартных основных полях ресурсов Google Workspace, например resource_ids и resource_details. Используйте эти поля, чтобы отслеживать идентификатор, название, тип, владельца и URL веб-страницы блокнота.
  • Параметры, относящиеся к событию, например исходный материал и сведения об артефакте на панели студии, вложенные в запись gemini_notebook.

О полях основного ресурса

В таблице ниже приведены основные поля ресурса в таблице activity, которые идентифицируют и описывают блокнот.

Название поля Тип Режим Описание
resource_ids СТРОКА ПОВТОРЯЕТСЯ Массив, содержащий уникальный идентификатор (UUID) блокнота.
resource_details ЗАПИСЬ ПОВТОРЯЕТСЯ Сведения о блокноте, связанном с событием журнала.
resource_details.id СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL UUID блокнота. Соответствует идентификатору блокнота в URL: https://notebook.google.com/notebook/id
resource_details.title СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Отображаемое название или заголовок блокнота.
resource_details.type СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Категория типа ресурса для блокнота (GEMINI_NOTEBOOK_NOTEBOOK)
resource_details.owner_details.owner_identity.user_identity.user_email СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Адрес электронной почты владельца блокнота.

Таблица шаблонов для Gemini Notebook

В таблице ниже описаны поля, относящиеся к событиям и вложенные в запись gemini_notebook в таблице activity. Компоненты схемы на этой странице иногда обновляются. После добавления новых полей они появляются в следующей ежедневной таблице, сгенерированной из шаблона. Если вам нужно запросить данные из новых полей, убедитесь, что вы обращаетесь к ежедневной таблице, созданной после обновления шаблона.

Подробнее о том, как указать или изменить схемы в BigQuery…

Название поля Тип Режим Описание
ai_plan_tier ENUM ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Уровень подписки пользователя на генеративный ИИ на момент события. Возможные значения:
  • AI Expanded
  • Plus
  • Pro
  • Стандартный
  • Ultra
prior_visibility ENUM ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Доступность блокнота до события. Возможные значения:
  • anyone_with_link
  • доступ ограничен
  • общедоступный
  • shared_internally
получатель СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Пользователь или группа, доступ которых был изменен в результате события.
recipient_access_type ENUM ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Тип доступа, предоставленного или отозванного у получателя. Возможные значения:
  • посмотреть
  • изменить
  • удалить
source_id СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Уникальный идентификатор исходного материала, на который ссылается блокнот.
source_name СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Отображаемое название исходного материала, на который ссылается блокнот.
source_type ENUM ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Тип данных источника. Возможные значения:
  • copied_text
  • диск
  • local_upload
  • URL (ссылка);
source_url СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL URL источника.
studio_artifact_id СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Уникальный идентификатор сгенерированного артефакта панели.
studio_artifact_name СТРОКА ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Отображаемое название объекта на панели студии.
studio_artifact_type ENUM ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Тип данных объекта панели Studio. Возможные значения:
  • audio_overview
  • data_table
  • карточки;
  • infographic
  • mind_map
  • тест
  • отчет
  • slide_deck
  • video_overview
доступ ENUM ДОПУСКАЕТ ЗНАЧЕНИЕ NULL Доступ к блокноту после мероприятия. Возможные значения:
  • anyone_with_link
  • доступ ограничен
  • общедоступный
  • shared_externally
  • shared_externally_trusted_domain
  • shared_internally

В этом примере используется стандартный SQL. Замените project-id.dataset-id идентификатором проекта и названием набора данных. Запрос возвращает уникальный идентификатор, название, тип ресурса, адрес электронной почты владельца, общее количество добавленных источников и сгенерированных артефактов панели Studio, а также прямой URL для каждого блокнота.

-- 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;