Ange schema för Gemini Notebook-loggar i BigQuery

När du läser in data i en tabell eller skapar en tom tabell i BigQuery måste du ange ett schema. På den här sidan beskriver vi tabellschemat och ger exempel på sökfrågor för vanliga rapporter som du kan få från BigQuery.

Om aktivitetstabellen

Du kan granska logghändelser för Gemini Notebook i aktivitetstabellen. Du kan hitta

  • anteckningsboksbehållaren i standardfälten för primära resurser i Google Workspace, till exempel resource_ids och resource_details. Använd dessa fält för att spåra anteckningsbokens id, titel, typ, ägare och webbadress.
  • Händelsespecifika parametrar, till exempel källmaterial och detaljer om artefakter i studiopanelen, som är inkapslade i gemini_notebook-posten.

Om fälten för primära resurser

I följande tabell definieras de primära resursfälten i tabellen activity som identifierar och beskriver anteckningsboken.

Fältnamn Type (Typ) Läge Beskrivning
resource_ids STRING UPPREPAD Matris som innehåller anteckningsbokens unika identifierare (UUID)
resource_details RECORD UPPREPAD Information om anteckningsboken som är kopplad till logghändelsen
resource_details.id STRING KAN NOLLAS UUID för anteckningsboken. Motsvarar anteckningsbokens id i webbadressen: https://notebook.google.com/notebook/id
resource_details.title STRING KAN NOLLAS Anteckningsbokens visningsnamn eller titel
resource_details.type STRING KAN NOLLAS Resurstypkategori för anteckningsboken (GEMINI_NOTEBOOK_NOTEBOOK)
resource_details.owner_details.owner_identity.user_identity.user_email STRING KAN NOLLAS E-postadress till anteckningsbokens ägare

Malltabell för Gemini Notebook

Följande malltabell definierar och beskriver de händelsespecifika fälten som är inkapslade i posten gemini_notebook i tabellen activity. Schemakomponenterna på den här sidan uppdateras ibland. När nya fält läggs till innehåller nästa dagliga tabell som genereras från mallen nya fält. Om du vill söka på nya fält ska du söka i dagliga tabeller som skapats efter att mallen uppdaterades.

Läs mer om hur du anger och modifierar scheman i BigQuery.

Fältnamn Type (Typ) Läge Beskrivning
ai_plan_tier ENUM KAN NOLLAS Användarens prenumerationsnivå för generativ AI när händelsen ägde rum. Möjliga värden:
  • AI Expanded
  • Plus
  • Pro
  • Standard
  • Ultra
prior_visibility ENUM KAN NOLLAS Anteckningsbokens synlighet före händelsen. Möjliga värden:
  • anyone_with_link
  • private
  • offentlig
  • shared_internally
mottagare STRING KAN NOLLAS Användare eller grupp vars åtkomst har ändrats i händelsen.
recipient_access_type ENUM KAN NOLLAS Typ av åtkomst som har beviljats eller tagits bort från mottagaren. Möjliga värden:
  • visa
  • redigera
  • ta bort
source_id STRING KAN NOLLAS Unik identifierare för källmaterialet som refereras i anteckningsboken.
source_name STRING KAN NOLLAS Visningsnamnet på källmaterialet som det hänvisas till i anteckningsboken.
source_type ENUM KAN NOLLAS Källans datatyp. Möjliga värden:
  • copied_text
  • drive
  • local_upload
  • url
source_url STRING KAN NOLLAS Webbadress till källan.
studio_artifact_id STRING KAN NOLLAS Unik identifierare för den genererade studio panel-artefakten.
studio_artifact_name STRING KAN NOLLAS Visningsnamn för artefakten i studiopanelen.
studio_artifact_type ENUM KAN NOLLAS Datatyp för Studio-panelartefakten. Möjliga värden:
  • audio_overview
  • data_table
  • frågekort
  • infographic
  • mind_map
  • quiz
  • report
  • slide_deck
  • video_overview
synlighet ENUM KAN NOLLAS Anteckningsbokens synlighet efter händelsen. Möjliga värden:
  • anyone_with_link
  • private
  • offentlig
  • shared_externally
  • shared_externally_trusted_domain
  • shared_internally

I det här exemplet används standard-SQL. Ersätt project-id.dataset-id med ditt projekt-id och datasetnamn. Sökfrågan returnerar den unika identifieraren, titeln, resurstypen, ägarens e-postadress, det totala antalet tillagda källor och artefakter som genererats i studiopanelen samt den direkta webbadressen för varje anteckningsbok.

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