Schema specificeren voor Gemini Notebook-logboeken in BigQuery

Als u gegevens laadt in een tabel of een lege tabel maakt in BigQuery, moet u een schema specificeren. Op deze pagina staan het tabelschema en voorbeeldquery's voor veelgebruikte rapporten die u kunt bekijken in BigQuery.

Over de activiteitentabel

U kunt gebeurtenissen in het logboek Gemini Notebook controleren in de activiteitentabel. U vindt het volgende:

  • De notebookcontainer in standaard primaire Google Workspace-bronvelden, zoals resource_ids en resource_details. Gebruik deze velden om de notebook-ID, titel, het type, de eigenaar en de web-URL bij te houden.
  • Gebeurtenisspecifieke parameters, zoals bronmateriaal en details van Studio-deelvensterartefacten, genest in de gemini_notebook-record.

Over de primaire bronvelden

In de volgende tabel staan de primaire bronvelden in de tabel activity die de notebook identificeren en beschrijven.

Veldnaam Type Modus Beschrijving
resource_ids TEKENREEKS HERHAALD Array met de unieke ID (UUID) van de notebook
resource_details RECORD HERHAALD Informatie over de notebook die aan de logboekgebeurtenis is gekoppeld
resource_details.id TEKENREEKS NULL-WAARDE MOGELIJK UUID voor de notebook. Komt overeen met de notebook-ID in de web-URL: https://notebook.google.com/notebook/id
resource_details.title TEKENREEKS NULL-WAARDE MOGELIJK Weergavenaam of titel van de notebook
resource_details.type TEKENREEKS NULL-WAARDE MOGELIJK Categorie resourcetype voor de notebook (GEMINI_NOTEBOOK_NOTEBOOK)
resource_details.owner_details.owner_identity.user_identity.user_email TEKENREEKS NULL-WAARDE MOGELIJK E-mailadres van de eigenaar van de notebook

Templatetabel voor Gemini Notebook

In de volgende templatetabel staan de gebeurtenisspecifieke velden die zijn genest in de gemini_notebook-record in de tabel activity. De schemacomponenten op deze pagina worden af en toe geüpdatet. Als er nieuwe velden worden toegevoegd, bevat de volgende dagelijkse tabel die wordt gegenereerd met de template de nieuwe velden. Als u een zoekopdracht wilt uitvoeren in nieuwe velden, moet u zoeken in de dagelijkse tabellen die zijn gegenereerd nadat de template is geüpdatet.

Meer informatie over het specificeren en aanpassen van schema's in BigQuery.

Veldnaam Type Modus Beschrijving
ai_plan_tier ENUM NULL-WAARDE MOGELIJK Het abonnementsniveau voor generatieve AI van de gebruiker op het moment dat de gebeurtenis plaatsvond. Mogelijke waarden:
  • AI Expanded
  • Plus
  • Pro
  • Standaard
  • Ultra
prior_visibility ENUM NULL-WAARDE MOGELIJK Zichtbaarheid van de notebook vóór de gebeurtenis. Mogelijke waarden:
  • anyone_with_link
  • privé
  • openbaar
  • shared_internally
ontvanger TEKENREEKS NULL-WAARDE MOGELIJK Gebruiker of groep waarvan de toegang is aangepast in de gebeurtenis.
recipient_access_type ENUM NULL-WAARDE MOGELIJK Het type toegang dat aan de ontvanger is verleend of van de ontvanger is verwijderd. Mogelijke waarden:
  • bekijken
  • bewerken
  • verwijderen
source_id TEKENREEKS NULL-WAARDE MOGELIJK De unieke ID van het bronmateriaal waarnaar wordt verwezen in de notebook.
source_name TEKENREEKS NULL-WAARDE MOGELIJK De weergavenaam van het bronmateriaal waarnaar wordt verwezen in de notebook.
source_type ENUM NULL-WAARDE MOGELIJK Het gegevenstype van de bron. Mogelijke waarden:
  • copied_text
  • drive
  • local_upload
  • url
source_url TEKENREEKS NULL-WAARDE MOGELIJK De URL van de bron.
studio_artifact_id TEKENREEKS NULL-WAARDE MOGELIJK De unieke ID van het gemaakte Studio-deelvensterartefact.
studio_artifact_name TEKENREEKS NULL-WAARDE MOGELIJK De weergavenaam van het Studio-deelvensterartefact.
studio_artifact_type ENUM NULL-WAARDE MOGELIJK Het gegevenstype van het Studio-deelvensterartefact. Mogelijke waarden:
  • audio_overview
  • data_table
  • flashcards
  • infographic
  • mind_map
  • toets
  • rapport
  • slide_deck
  • video_overview
zichtbaarheid ENUM NULL-WAARDE MOGELIJK De zichtbaarheid van de notebook na de gebeurtenis. Mogelijke waarden:
  • anyone_with_link
  • privé
  • openbaar
  • shared_externally
  • shared_externally_trusted_domain
  • shared_internally

In dit voorbeeld wordt standaard-SQL gebruikt. Vervang project-id.dataset-id door uw project-ID en datasetnaam. De query retourneert de unieke ID, titel, het resourcetype, het e-mailadres van de eigenaar, het totale aantal toegevoegde bronnen en gemaakte Studio-deelvensterartefacten en de rechtstreekse URL voor elke 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;