package notebooklm.v1alpha1
Get desktop application:
View/edit binary Protocol Buffers messages
rpc DeleteGuidebook (, )
sharing.proto:265Guidebook operations
message
sharing.proto:144string guidebook_id = 1
rpc GetGuidebook (, )
sharing.proto:269message
sharing.proto:148string guidebook_id = 1
rpc GetGuidebookDetails (, )
sharing.proto:281message
sharing.proto:177string guidebook_id = 1
message
sharing.proto:181optional guidebook = 1
repeated sections = 2
optional analytics = 3
message
sharing.proto:210string guidebook_id = 1
string question = 2
optional settings = 3
message
sharing.proto:222string answer = 1
repeated sources = 2
float confidence_score = 3
message
sharing.proto:152int32 page_size = 1
string page_token = 2
message
sharing.proto:157repeated guidebooks = 1
string next_page_token = 2
rpc PublishGuidebook (, )
sharing.proto:277message
sharing.proto:162string guidebook_id = 1
optional settings = 2
message
sharing.proto:172optional guidebook = 1
string public_url = 2
Service definition
rpc ActOnSources (, )
orchestration.proto:500Source operations
message
orchestration.proto:137string project_id = 1
string action = 2
repeated string source_ids = 3
rpc AddFileSource (, )
orchestration.proto:723Source registration for Resumable Upload (rpc.go:31) Request shape, captured from api.Client.registerFileSource (internal/notebooklm/api/client.go:952): [[[filename]], project_id, [2], [1, null × 9, [1]]] The arg_format directive cannot express the deeply-nested wrapper; a custom encoder lives at api.Client.registerFileSource. Returns the server-assigned source_id at response position [0][0][0].
message
orchestration.proto:1347AddFileSource (o4cbdc): register an uploaded file as a notebook source. HAR-verified across two pdf-upload captures (2026-04-19, pdf-upload/, pdf-upload-new/) — both byte-identical for the trailing options blob. Wire request: [[[filename]], project_id, [2], [1, null × 9, [1]]] Position [0] is a 2-level-nested filename list (the inner [filename] is a 1-element list). Position [2] is [2] = source_type=file_upload. Position [3] is the same fixed options blob seen in DeleteArtifact's V5N4be call. See api.Client.registerFileSource (client.go:952).
string project_id = 1
string filename = 2
message
orchestration.proto:1361Wire response (HAR-verified): [[[[source_id], filename, [null, null, null, null, 0]]], null, [[[[source_id], filename, [null, null, null, null, 0]]]]] Positions [0] and [2] both echo the assigned source row; [1] is always null in the captured calls. The inner metadata list at position [2] of each row is [null × 4, status_int=0]. We surface the source_id only.
string source_id = 1
string filename = 2
rpc AddSources (, )
orchestration.proto:504message
orchestration.proto:359Update existing request messages to match Gemini's findings
repeated sources = 1
string project_id = 2
BulkImportFromResearch (rpc.go:73). 5-position polymorphic variant of LBwxtb that imports a batch of URL+title pairs from a research session. HAR-verified 2026-04-17 against notebook 00000000-0000-4000-8000-000000000006, conversation 00000000-0000-4000-8000-000000000401, ten URL sources. Request shape (api.bulkImportArgs at client.go:5102): [null, [1], conversation_id, project_id, [source_1, ..., source_N]] Each source tuple is 11-position; encoded by Go helper because arg_format cannot represent the inner [null, null, [url, title], null × 7, 2] tuple shape.
message
orchestration.proto:1484BulkImportFromResearch (LBwxtb, 5-position polymorphic variant). Wire shape: [null, [1], conversation_id, project_id, [source_1, ..., source_N]] HAR captures show two distinct per-source tuple shapes selected by position [10]: URL import (api.bulkImportArgs at client.go:5102, source_type=2): [null, null, [url, title], null × 7, 2] Note/text import (HAR-observed in NotebookLM web UI capture, 2026-04-23, importing a 3.4kB markdown research report, source_type=3): [null, [title, content_markdown], null, 3, null × 5, 3] The Go side currently encodes only the URL variant; the note variant is a follow-up. BulkImportSourceInput carries enough fields to model both — content stays empty for URL imports, url stays empty for note imports.
string project_id = 1
string conversation_id = 2
repeated sources = 3
message
orchestration.proto:1505BulkImportFromResearchResponse — per-source enriched metadata in request order. HAR shows a wide layout; we surface the durable subset (id, title, url) and leave the rest to future callers.
repeated results = 1
CancelDiscoverSourcesJob (Zbrupe). Cancels an in-flight DiscoverSources / DiscoverSourcesAsync / DiscoverSourcesManifold job. JS-bundle-verified; no HAR yet. TODO(har): trigger by canceling a running fast-research / deep-research / discover-sources flow before completion.
message
orchestration.proto:1798CancelDiscoverSourcesJob (Zbrupe).
string project_id = 1
string job_id = 2
message
orchestration.proto:1138string source_id = 1
message
orchestration.proto:1142bool is_fresh = 1
optional last_checked = 2
rpc CopyProject (, )
orchestration.proto:1080CopyProject (te3DCe). Duplicates an existing notebook (sources, artifacts, settings) into a new project. JS-bundle-verified; no HAR. TODO(har): trigger from the "Make a copy" notebook menu.
message
orchestration.proto:1895CopyProject (te3DCe). Duplicates a notebook.
string source_project_id = 1
string new_title = 2
Artifact operations
message
orchestration.proto:87optional context = 1
string project_id = 2
optional artifact = 3
Audio operations
message
orchestration.proto:175string project_id = 1
AudioType audio_type = 2
repeated string source_ids = 3
string custom_instructions = 4
AudioLength length = 5
string language = 6
e.g. "en"
CreateAudioOverview (AHyHrd). The legacy audio-overview creator. The production surface now goes through CreateUniversalArtifact (R7cb6c with kind=2), but a direct AHyHrd path is still wired in api.Client.createAudioOverviewDirectRPC (client.go:1407) as a fallback. JS-bundle-verified; HAR-observed under that fallback.
message
orchestration.proto:1907CreateAudioOverviewLegacy (AHyHrd). Direct-RPC fallback that api.Client.createAudioOverviewDirectRPC still uses; the live UI now goes through R7cb6c. The "Legacy" suffix avoids a name collision with the modern CreateAudioOverview rpc that targets R7cb6c above.
string project_id = 1
int32 audio_type = 2
repeated string instructions = 3
rpc CreateLabel (, )
orchestration.proto:976CreateLabel / MutateLabel / DeleteLabels — write companions to GetLabels (I3xc3c). All three are bound by the JS bundle but no HAR has been captured yet; trigger by interacting with the labels affordance in the source-list UI.
message
orchestration.proto:1767Label write companions — wire shape unverified.
string project_id = 1
string name = 2
message
orchestration.proto:1772optional label = 1
rpc CreateNote (, )
orchestration.proto:576Note operations
message
orchestration.proto:383string project_id = 1
string content = 2
repeated int32 note_type = 3
string title = 5
rpc CreateProject (, )
orchestration.proto:594Project operations
message
orchestration.proto:1100Request messages reconstructed from captured batchexecute traffic.
string title = 1
string emoji = 2
Video operations (uses same R7cb6c RPC as audio but with mode=3)
message
orchestration.proto:185Video overview request (uses same R7cb6c RPC as audio, but with mode=3 parameter)
string project_id = 1
AudioType audio_type = 2
Content style (only BRIEF=2 observed so far)
repeated string source_ids = 3
string custom_instructions = 4
VideoStyle video_style = 5
Visual presentation style
string language = 6
e.g. "en"
message
orchestration.proto:112string artifact_id = 1
message
orchestration.proto:199string project_id = 1
message
orchestration.proto:1209string project_id = 3
Wire format: [null, null, %project_id%] Polymorphic endpoint shared with PollDeepResearch
DeleteDeepResearch (rpc.go:72). Soft-delete a research session; server transitions state 2 -> 5 (the row is retained, future poll queries skip state=5). HAR-verified 2026-04-17. Polymorphic with BulkImportFromResearch: same LBwxtb id, server discriminates on arg-4 presence (delete = 4-position, bulk-import = 5-position). Request shape (api.deleteDeepResearchArgs at client.go:5034): [null, [1], conversation_id, project_id]
message
orchestration.proto:1455DeleteDeepResearch (LBwxtb, 4-position polymorphic variant). Wire shape: [null, [1], conversation_id, project_id]
string project_id = 1
string conversation_id = 2
message
orchestration.proto:1460empty array on success
(message has no fields)
rpc DeleteLabels (, )
orchestration.proto:984message
orchestration.proto:1785repeated string label_ids = 1
rpc DeleteNotes (, )
orchestration.proto:580message
orchestration.proto:390string project_id = 1
repeated string note_ids = 3
message
orchestration.proto:1105repeated string project_ids = 1
rpc DeleteSources (, )
orchestration.proto:512message
orchestration.proto:1109repeated string source_ids = 1
DiscoverSources (Es3dTe). Per the JS bundle binding to /LabsTailwindOrchestrationService.DiscoverSources. The previous rpc_id "qXyaNe" was a speculative inference that does not match any JS bundle entry or HAR capture; corrected to Es3dTe. No HAR yet for the wire shape. arg_format below is a likely shape based on sibling RPCs but is unverified — TODO(har): capture by triggering "Discover sources" from the source-add UI. Note: the related research-flow RPCs (Ljjv0c, QA9ei, e3bVqc, LBwxtb) are bound by the JS bundle to DiscoverSources*-family names (DiscoverSourcesManifold, DiscoverSourcesAsync, ListDiscoverSourcesJob, FinishDiscoverSourcesRun); the "research" feature is layered on top of the DiscoverSources job system.
message
orchestration.proto:203string project_id = 1
string query = 2
message
orchestration.proto:208repeated sources = 1
ExecuteWritingFunction (likKIe). In-document writing assistant — rewrite, expand, summarize a selection inside an artifact. JS-bundle-verified; no HAR. TODO(har): trigger from the artifact editor's writing toolbar.
message
orchestration.proto:1843ExecuteWritingFunction (likKIe). In-document writing assistant.
string project_id = 1
string artifact_id = 2
string selection_text = 3
string function = 4
e.g. "rewrite", "expand", "summarize"
message
orchestration.proto:1850string transformed_text = 1
ExportToDrive (Krh3pd). Pushes notebook artifacts to the user's Drive. JS-bundle-verified; no HAR yet. TODO(har): trigger by clicking "Export to Drive" on a notebook.
message
orchestration.proto:1804ExportToDrive (Krh3pd). wire shape unverified.
string project_id = 1
repeated string artifact_ids = 2
message
orchestration.proto:1809string drive_url = 1
string drive_file_id = 2
FetchInteractivityToken (rpc.go:50). Voice-session auth + ICE server config for the WebRTC interactive-audio mode. Request is the empty payload []. Response is a positional JSON envelope whose [0] field is a JSON-encoded string carrying {lifetimeDuration, iceServers, blockStatus, iceTransportPolicy}. See internal/interactiveaudio/signaling.go:36 and the existing FetchInteractivityTokenRequest/Response messages at line 858+.
message
orchestration.proto:1315FetchInteractivityToken (Of0kDd). HAR-verified (docs/captures/notebooklm.google.com.jsonl:24, 2026-04-06). Request is the empty payload []. Response is a 1-element JSON array whose [0] entry is a JSON-encoded string carrying the WebRTC bootstrap blob: lifetimeDuration, iceServers (STUN+TURN credentials), blockStatus, and iceTransportPolicy. Decoded by interactiveaudio.parseInteractivityTokenResponse (signaling.go:72) which JSON-unmarshals the inner string into a Go-side InteractivityToken struct that mirrors these fields.
Wire format: [] (empty payload)
(message has no fields)
message
orchestration.proto:1319string lifetime_duration = 1
e.g. "86400s"
repeated ice_servers = 2
string block_status = 3
e.g. "NOT_BLOCKED"
string ice_transport_policy = 4
e.g. "all"
GenerateAccessToken (preRPe). Per-session token mint — likely used by embed widgets or third-party surfaces that need a short-lived credential. JS-bundle-verified; no HAR.
message
orchestration.proto:1873GenerateAccessToken (preRPe). Per-session token mint.
string project_id = 1
message
orchestration.proto:1877string access_token = 1
optional expires_at = 2
GenerateArtifact (Rytqqe). Distinct from CreateArtifact (xpWGLf) and CreateUniversalArtifact (R7cb6c). Likely the trigger that takes a SUGGESTED-state artifact (see ArtifactState.SUGGESTED) and promotes it to a generated one. JS-bundle-verified; no HAR yet. TODO(har): trigger by clicking a suggested-artifact card.
message
orchestration.proto:1792GenerateArtifact (Rytqqe) — distinct from CreateArtifact (xpWGLf) and CreateUniversalArtifact (R7cb6c). Likely promotes a SUGGESTED artifact to a generated one. wire shape unverified.
string project_id = 1
string artifact_id = 2
GenerateArtifactSuggestions / AudioTopicSuggestions (rpc.go:133). The web UI calls this before R7cb6c (CreateUniversalArtifact) to get a list of AI-generated topic blueprints. Wire format verified against HAR (create-audio, 2026-04-14): [[kind], project_id, [[src1], [src2], ...], variation] Only audio (kind=2) is HAR-verified; video and slide kinds are not covered. The variation int re-rolls suggestions (1, 2, 5, 6 observed). See internal/method/labs_tailwind_artifact_suggestions.go.
message
orchestration.proto:1639GenerateArtifactSuggestions / AudioTopicSuggestions (otmP3b). HAR-verified for kind=2 (audio) via the create-audio capture used for internal/method/labs_tailwind_artifact_suggestions.go (filed 2026-04-14; not present in this repo's docs/captures/ but the encoder is the durable record). Wire request: [[kind], project_id, [[src1], [src2], ...], variation] Wire response: [[[title, description], [title, description], ...]] Each call returns three suggestion pairs. variation is a re-roll seed (1, 2, 5, 6 observed); the UI bumps it on every "refresh" click. Video and slide kinds are not yet HAR-verified.
int32 kind = 1
2 = audio (HAR-verified); 3,4 speculative
string project_id = 2
repeated string source_refs = 3
int32 variation = 4
re-roll seed
message
orchestration.proto:1653repeated suggestions = 1
GenerateDocumentGuides (rpc.go:82). Per-source guide RPC: the wire call is keyed by source_id with a 4-level-nested arg shape [[[[source_id]]]] that the arg_format template cannot express. Invoked via api.Client.GenerateSourceGuide (client.go:3010); response is [[[null, [summary], [[topic, ...]], []]]]. The request message exists at line 709 (GenerateDocumentGuidesRequest).
message
orchestration.proto:1156string project_id = 1
message
notebooklm.proto:163repeated guides = 1
rpc GenerateFreeFormStreamed (, stream )
orchestration.proto:630Generation operations Per-source guide generation (tr032e) is not declared here; the wire call is keyed by source_id with a 4-level-nested arg shape that the [%project_id%]-style arg_format cannot express. It's invoked directly via rpc.Do in the api package (see api.Client.GenerateSourceGuide).
message
orchestration.proto:225string project_id = 1
The gRPC-Web endpoint still expects a manually constructed JSON array, but this message mirrors the observed request state on that wire: [ [[[source_ids]]], prompt, history, [mode, null, citation_modes, follow_up_modes], conversation_id, draft_response_id, parent_response_id, notebook_id, sequence_number ]
string prompt = 2
repeated string source_ids = 3
repeated history = 4
optional options = 5
string conversation_id = 6
string draft_response_id = 7
string parent_response_id = 8
string notebook_id = 9
int32 sequence_number = 10
message
orchestration.proto:289string chunk = 1
chunk preserves the cumulative answer text used by existing callers.
bool is_final = 2
is_final mirrors the completion flag at response position [4].
optional conversation = 3
repeated citations = 4
repeated source_mappings = 5
repeated string follow_up_text = 6
repeated follow_ups = 7
message
notebooklm.proto:346string project_id = 1
repeated string source_ids = 2
message
notebooklm.proto:355string title = 1
repeated items = 4
message
orchestration.proto:1160string project_id = 1
GuideType guide_type = 2
Type of guide to generate (2 = mind map)
message
notebooklm.proto:171string content = 1
message
orchestration.proto:1165string project_id = 1
message
notebooklm.proto:175string content = 1
GenerateReportSuggestions (ciyUvf). HAR-verified; see internal/method/LabsTailwindOrchestrationService_GenerateReportSuggestions_encoder.go. GHsKob is a legacy/predecessor id for the same logical RPC. It does not appear in the current JS bundle (boq_labs-tailwind-frontend) and has no observed wire traffic. Treat GHsKob as dead; ciyUvf is the live id.
message
orchestration.proto:301string project_id = 1
repeated string source_ids = 2
message
orchestration.proto:315repeated suggestions = 1
message
orchestration.proto:1169string project_id = 1
message
notebooklm.proto:179string content = 1
rpc GetArtifact (, )
orchestration.proto:457GetArtifact (v9rmvd). The JS bundle binds v9rmvd to /LabsTailwindOrchestrationService.GetArtifact, so the RPC does exist on the wire — it just isn't invoked by the live web UI, which prefers gArtLc (ListArtifacts) + client-side filter for its rendering path. The earlier BnLyuf id was a different, unreachable inference that returned 400. No HAR evidence in the surveyed corpus (the UI never fires this ID). api.Client.GetArtifact still uses the gArtLc scan fallback; a future direct caller can target v9rmvd once a wire shape is captured. TODO(har): capture the request/response shape by hitting v9rmvd directly (e.g., from a custom JS console snippet) and refine GetArtifactRequest/Response.
message
orchestration.proto:98GetArtifactRequest. The wire id is v9rmvd (per JS bundle binding to /LabsTailwindOrchestrationService.GetArtifact). The web UI never fires this RPC, preferring a gArtLc scan + filter, so the request shape is unverified by HAR. arg_format = "[%artifact_id%]" is the likely shape based on sibling artifact RPCs.
string artifact_id = 1
GetArtifactUserState (ulBSjf). Read companion to UpsertArtifactUserState (Fxmvse). Both are bound by the JS bundle to /LabsTailwindOrchestrationService.GetArtifactUserState. No standalone HAR observed: the read path is rolled into the gArtLc (ListArtifacts) response — each artifact tuple already carries the saved ArtifactUserState inline at a late field position (the same [[[seconds, nanos]]] shape that Fxmvse upserts). The dedicated ulBSjf read is reserved for hosts that need the per-artifact value without re-listing. TODO(har): capture a direct ulBSjf request to confirm the request body shape; the read response is expected to mirror UpsertArtifactUserStateResponse (a single ArtifactUserState).
message
orchestration.proto:1758GetArtifactUserState (ulBSjf). Read companion to UpsertArtifactUserState (Fxmvse). No HAR observed for the dedicated read path: the value is also returned inline by gArtLc (ListArtifacts) as part of each artifact tuple, and the UI reads it from there. The fields below mirror the HAR-verified write side; the request likely sends only the artifact_id, and the response is expected to wrap a single ArtifactUserState the same way as UpsertArtifactUserStateResponse. TODO(har): capture a standalone ulBSjf request to confirm.
string artifact_id = 1
message
orchestration.proto:1762optional state = 1
GetAudioFormats (rpc.go:89). HAR-verified 2026-04-07 in docs/captures/notebooklm.google.com.jsonl. Request payload observed verbatim: [[2, null, null, [1, null × 9, [1]], [[1,4,2,3,6,5]]], null, 1] Returns the audio-overview style menu (Deep Dive, Brief, Critique, Debate). The opaque inner [1, null × 9, [1]] and ordering vector [[1,4,2,3,6,5]] are bytes captured verbatim; semantics not yet decoded.
message
orchestration.proto:1522GetAudioFormats (sqTeoe). HAR-verified against 11+ captures (notebooklm.google.com.jsonl, 2026-04-19..2026-04-23). Returns the full create-artifact menu — audio styles, video styles, slide styles, AND the prebuilt briefing-doc/study-guide templates. The request is a fixed-sentinel payload (no varying fields), so it has no arg_format. The same RPC powers every "create X" picker the UI shows.
Wire shape: [[2, null, null, [1, null × 9, [1]], [[1,4,2,3,6,5]]], null, 1] Custom encoder; no field substitution.
(message has no fields)
message
orchestration.proto:1539Response shape (HAR-verified): [ [<audio_kinds>], // [[id, name, description], ...] [<video_kinds>], [<slide_kinds>], [<doc_templates>], // [title, subtitle, system_prompt] ..., ] We surface only the audio kinds today (the existing api.Client.GetAudioFormats path); other inner arrays are accessible via the raw payload until dedicated parsers exist.
repeated formats = 1
message
orchestration.proto:194string project_id = 1
int32 request_type = 2
message
orchestration.proto:1200string project_id = 1
string conversation_id = 2
message
orchestration.proto:1205repeated messages = 1
Conversation lifecycle
message
orchestration.proto:1190string project_id = 3
Wire format: [[], null, %project_id%, %limit%]
int32 limit = 4
message
orchestration.proto:1196repeated string conversation_ids = 1
GetDeepResearchSessions (rpc.go:71). Polymorphic with DeleteChatHistory: same e3bVqc id, server discriminates on request payload shape. The deep/fast-session list call uses [null, null, project_id] (api.Client.pollResearch at client.go:4758). Returns ALL deep + fast sessions for the notebook; the caller scans by (research_id, mode=5) for deep or (conversation_id, mode=1) for fast.
message
orchestration.proto:1435GetDeepResearchSessions (e3bVqc, polymorphic with DeleteChatHistory). Wire shape: [null, null, project_id] Response is a list of deep+fast research sessions; clients filter by (research_id, mode=5) for deep or (conversation_id, mode=1) for fast.
string project_id = 1
message
orchestration.proto:1439repeated sessions = 1
rpc GetLabels (, )
orchestration.proto:931GetLabels (I3xc3c). JS bundle binds this to /LabsTailwindOrchestrationService.GetLabels. HAR-verified across 8+ NotebookLM web UI captures (2026-04-23). Returns the notebook's labels (a.k.a. autolabel/source-grouping clusters): per-label tuples carrying a label, a member source list, and a server-assigned group UUID. Most notebooks return [] (no labels computed yet). Notebooks where the user has invoked autolabel return populated entries. Wire request: [[2], project_id] [0] = [2] is an opaque mode/operation enum (constant across all captures); semantics not yet decoded. Wire response: [] OR [[label, [[src_id], ...], group_uuid, ""], ...] Earlier rounds of this proto called this method GetSourceGroups — the canonical service name (per JS bundle) is GetLabels, and the related operations CreateLabel (agX4Bc), MutateLabel (le8sX), and DeleteLabels (GyzE7e) confirm the labels framing.
message
orchestration.proto:1681GetLabels (I3xc3c). HAR-verified label/autolabel query. The notebook UI fires this on every notebook load to render the source-list section headers; an empty response means the user hasn't yet computed labels for this notebook.
string project_id = 1
message
orchestration.proto:1685repeated labels = 1
rpc GetMagicView (, )
orchestration.proto:1071GetMagicView (rtY7md). Read companion to GenerateMagicView (uK8f7c). JS-bundle-verified; no HAR. TODO(har): trigger by opening a previously-generated Magic View.
message
orchestration.proto:1883GetMagicView (rtY7md). Read companion to GenerateMagicView (uK8f7c).
string project_id = 1
string magic_view_id = 2
message
orchestration.proto:1888string magic_view_id = 1
string content = 2
optional generated_at = 3
rpc GetNotes (, )
orchestration.proto:584message
orchestration.proto:395string project_id = 1
message
notebooklm.proto:140repeated notes = 1
Account operations
message
orchestration.proto:412Account management
Empty for now, uses auth token
(message has no fields)
rpc GetProject (, )
orchestration.proto:602message
orchestration.proto:1113string project_id = 1
Analytics and feedback
message
orchestration.proto:320string project_id = 1
message
orchestration.proto:324optional source_count = 1
optional note_count = 2
optional audio_overview_count = 3
optional last_accessed = 4
rpc ListArtifacts (, )
orchestration.proto:487message
orchestration.proto:116string project_id = 1
int32 page_size = 2
string page_token = 3
message
orchestration.proto:122repeated artifacts = 1
string next_page_token = 2
ListExpertIntelligenceContent (mVtEUb). Curated featured-content surface (the "Expert intelligence" gallery). JS-bundle-verified; no HAR. TODO(har): visit the featured/expert-content tab to capture.
message
orchestration.proto:1855ListExpertIntelligenceContent (mVtEUb). Curated featured surface.
int32 page_size = 1
string page_token = 2
message
orchestration.proto:1860repeated items = 1
string next_page_token = 2
message
orchestration.proto:331(message has no fields)
message
orchestration.proto:354repeated projects = 1
ListModelOptions (EnujNd). Returns the menu of available chat / generation models for the signed-in account. JS-bundle-verified; no HAR yet. TODO(har): trigger by opening the model-picker in chat.
message
orchestration.proto:1821ListModelOptions (EnujNd). wire shape unverified.
string project_id = 1
message
orchestration.proto:1825repeated models = 1
message
orchestration.proto:1117optional limit = 1
optional offset = 2
optional filter = 3
repeated int32 options = 4
message
notebooklm.proto:192repeated projects = 1
rpc LoadSource (, )
orchestration.proto:536message
orchestration.proto:1147string source_id = 1
rpc LogEvent (, )
orchestration.proto:845LogEvent / GetPromoCampaign (rpc.go:98). The constant in rpc.go is labelled "LogEvent" but HAR evidence (notebooklm.google.com.jsonl hits across 12+ captures spanning 2026-04-19..2026-04-23) shows it is actually a promo/upsell-card placement lookup. The web UI fires it once per page load. Request shape: [[[[null, "1", 627], [null × 9, [null, null, 2]], 1]]] The middle-positional 627 looks like the campaign/promo slot ID; "1" is locale or surface; the [null, null, 2] tail is opaque. Response carries the upsell card payload (icon URL, title, CTA link, the user's tier — e.g. "NOTEBOOKLM_TIER_PRO_CONSUMER_USER"). The Go side does not call this RPC; it is documented here so the proto matches what the wire actually does.
message
orchestration.proto:1576LogEvent (ozz5Z) is a misnomer per rpc.go's constant; the wire RPC is actually a promo/upsell-card placement lookup. HAR-verified across 12+ captures (notebooklm.google.com.jsonl, 2026-04-19..2026-04-23). Wire request: [[[[null, "1", 627], [null × 9, [null, null, 2]], 1]]] 627 is the campaign/slot id (constant across all captures); "1" is locale/surface; the [null, null, 2] tail at position [9] of the inner array is opaque. The whole request is a fixed sentinel — the only varying byte is the f.sid, which lives outside the f.req body. No Go caller invokes this RPC today; the message exists so future regenerated stubs match the wire reality rather than the rpc.go label.
No fields: the request is a constant sentinel envelope.
(message has no fields)
message
orchestration.proto:1594Wire response carries the upsell card payload. Captured layout (heavily nested; only the surfaceable subset is decoded here): [[[ [null, "1", 627], [[1601, [null × 9, [[null, "NotebookLM icon", "edit"], [[[null, null, "<settings_url>"], false], null, null, "Manage subscription", null, "Manage subscription", null, null, [<dismissal_blob>]]]], null × 8, "NOTEBOOKLM_TIER_PRO_CONSUMER_USER", null, null, false]], 0]]] We surface the user-tier string (the only durable, human-meaningful field). All other content is rendering metadata.
string user_tier = 1
Example value: "NOTEBOOKLM_TIER_PRO_CONSUMER_USER".
rpc MutateAccount (, )
orchestration.proto:710message
orchestration.proto:416optional account = 1
optional update_mask = 2
rpc MutateLabel (, )
orchestration.proto:980message
orchestration.proto:1776string label_id = 1
string name = 2
message
orchestration.proto:1781optional label = 1
rpc MutateNote (, )
orchestration.proto:588message
orchestration.proto:399string project_id = 1
string note_id = 2
repeated updates = 3
rpc MutateProject (, )
orchestration.proto:615message
orchestration.proto:1124string project_id = 1
optional updates = 2
rpc MutateSource (, )
orchestration.proto:540message
orchestration.proto:1129string source_id = 1
optional updates = 2
message
orchestration.proto:127repeated int32 artifact_types = 1
string project_id = 2
string filter = 3
message
orchestration.proto:133repeated artifacts = 1
Conversation feedback (rpc.go:65) TODO(har): wire shape unverified — no rpcids=J7Gthc seen in any capture under NotebookLM web UI capture corpus or docs/captures/. To capture: (1) load a notebook with chat history, (2) click thumbs-up or thumbs-down on an assistant reply, (3) grab the resulting batchexecute POST. Until captured, do not call this RPC — the placeholder fields are speculative.
message
orchestration.proto:1371RateConversationTurn (J7Gthc): thumbs-up/down on a chat turn. TODO(har): no rpcids=J7Gthc seen in any current capture. To capture: (1) load a notebook with chat history, (2) click a thumbs-up or thumbs-down icon on an assistant reply. The fields below are speculative — do NOT call this RPC until the wire is captured.
string project_id = 1
string conversation_id = 2
string turn_id = 3
int32 rating = 4
speculative: 1=up, 2=down
message
orchestration.proto:1378wire shape unverified; capture HAR before encoding
(message has no fields)
rpc RefreshSource (, )
orchestration.proto:544message
orchestration.proto:1151string source_id = 1
string project_id = 2
Needed for source-path URL param
message
orchestration.proto:1134string project_id = 1
message
orchestration.proto:107string artifact_id = 1
string new_title = 2
rpc ReportContent (, )
orchestration.proto:860ReportContent. User-initiated abuse/safety report. The JS bundle binds the live ReportContent endpoint to OmVMXc; the historical rJKx8e id never surfaced in any HAR capture or in the bundle, so it is treated as stale (kept as RPCReportContentLegacy for compatibility, no proto entry). TODO(har): no rpcids=OmVMXc seen in any capture under the current web-UI corpus. To capture: open an artifact, click the kebab menu -> "Report", fill the dialog, submit. The placeholder fields are speculative.
message
orchestration.proto:1601ReportContent (rJKx8e): user-initiated abuse/safety report. wire shape unverified; capture HAR before encoding
string project_id = 1
wire shape unverified; capture HAR before encoding
string artifact_id = 2
string reason = 3
string detail = 4
message
orchestration.proto:1609wire shape unverified; capture HAR before encoding
(message has no fields)
ReviseArtifact (rpc.go:131). Re-runs an artifact generator with a free-form revision instruction. TODO(har): no rpcids=KmcKPe seen in any capture. To capture: open a generated artifact (audio overview, briefing doc, mind map), click "Revise" or the equivalent edit affordance, type an instruction, submit. The placeholder fields are speculative.
message
orchestration.proto:1615ReviseArtifact (KmcKPe): revise an artifact with instructions. wire shape unverified; capture HAR before encoding
string project_id = 1
wire shape unverified; capture HAR before encoding
string artifact_id = 2
string instructions = 3
message
orchestration.proto:1622optional artifact = 1
wire shape unverified; capture HAR before encoding
rpc SDPExchange (, )
orchestration.proto:906SDPExchange (rpc.go:51). WebRTC SDP offer/answer exchange for the interactive-audio voice session. Request payload is a single string holding {"sdp": "...", "type": "offer"} JSON; the server returns the answer SDP wrapped the same way. See internal/interactiveaudio/signaling.go:52.
message
orchestration.proto:1667SDPExchange (eyWvXc): WebRTC SDP offer/answer exchange. HAR-verified (docs/captures/notebooklm.google.com.jsonl:25, 2026-04-06) — request args = [json_str] where json_str is `{"sdp":"...","type":"offer"}`. Response is `[json_str]` where json_str is the answer SDP wrapped the same way, with `"type":"answer"` and an active fingerprint. Encoded/decoded by interactiveaudio.exchangeSDP (signaling.go:52). The wire keeps the SDP as an opaque JSON-encoded string blob; this proto exposes the decoded sdp+type pair for callers that prefer structured access.
string offer_payload = 1
Raw JSON string sent on the wire — kept as a string because the server treats it opaquely and round-trips byte-for-byte.
message
orchestration.proto:1673string answer_payload = 1
StartDeepResearch (rpc.go:70). Wire shape verified across three independent CDP captures spanning 2026-04-10 through 2026-04-17 (api.Client.StartDeepResearch at client.go:4686). Request: [null, [1], [query, 1], 5, project_id] Response is a two-element array: [research_id, conversation_id].
message
orchestration.proto:1421StartDeepResearch (QA9ei): kick off a deep-research session. Wire shape verified across three independent CDP captures spanning 2026-04-10..2026-04-17 (api.Client.StartDeepResearch at client.go:4686). No HAR copy in this repo's capture set; the verification is the dedicated capture suite that gated this RPC from speculative to first-class. Wire request: [null, [1], [query, 1], 5, project_id] Wire response: [research_id, conversation_id] Position [3] = 5 distinguishes deep from fast (which uses 1 at the same position structurally, though shifted because the leading null + [1] are absent in fast). Both IDs are retained because different downstream RPCs key on different ones (poll uses research_id, delete uses conversation_id).
string project_id = 1
string query = 2
message
orchestration.proto:1426string research_id = 1
string conversation_id = 2
rpc StartDraft (, )
orchestration.proto:667message
orchestration.proto:1173string project_id = 1
message
notebooklm.proto:183(message has no fields)
Research operations StartFastResearch — HAR-verified 2026-04-17 against notebook 00000000-0000-4000-8000-000000000006 (rpc.go:68). Request shape (api.startFastResearchArgs at client.go:4587): [[query, 1], null, 1, project_id] Response is a one-element array: [conversation_id]. Mode enum at position [2] is 1 for fast (5 for deep, see StartDeepResearch).
message
orchestration.proto:1397StartFastResearch (Ljjv0c): kick off a fast-research session. Wire shape verified by api.startFastResearchArgs (client.go:4587), against notebook 00000000-0000-4000-8000-000000000006, query "har harl file formats" (NotebookLM web UI capture, 2026-04-17). No HAR copy in this repo's capture set. JS bundle binding: Ljjv0c → DiscoverSourcesManifold. The "research" feature is built on top of the DiscoverSources job system; api.Client uses the StartFastResearch alias. Wire request: [[query, 1], null, 1, project_id] Wire response: [conversation_id] Mode int at position [2] is 1 for fast, 5 for deep. The trailing 1 at position [0][1] is opaque (same byte the deep variant carries).
string project_id = 1
string query = 2
message
orchestration.proto:1402string conversation_id = 1
rpc StartSection (, )
orchestration.proto:671message
orchestration.proto:1177string project_id = 1
message
notebooklm.proto:186(message has no fields)
message
orchestration.proto:1181string project_id = 1
string feedback_type = 2
string feedback_text = 3
message
orchestration.proto:102optional artifact = 1
optional update_mask = 2
UpdateFeaturedNotebookStatus (DemIHe). Admin/internal. Fired only by the featured-notebook curation surface. JS-bundle-verified; unlikely to ever be exercised by an end-user account.
message
orchestration.proto:1815UpdateFeaturedNotebookStatus (DemIHe). Admin-only.
string project_id = 1
bool featured = 2
UpdateProjectUserState (LQhfEb). Per-user notebook state — last-viewed-at, pinned, hidden, etc. JS-bundle-verified; no HAR. TODO(har): trigger by pinning/unpinning a notebook.
message
orchestration.proto:1836UpdateProjectUserState (LQhfEb). wire shape unverified.
string project_id = 1
bool pinned = 2
optional last_viewed_at = 3
UpsertArtifactUserState (Fxmvse). JS bundle binds this to /LabsTailwindOrchestrationService.UpsertArtifactUserState. The companion read RPC is GetArtifactUserState (ulBSjf). HAR-verified 2026-04-25 against NotebookLM web UI interactive-audio capture set (22 samples). The web UI fires this every ~5s during interactive audio-overview playback to persist the listener's playback position. The request body is [%context%, %artifact_id%, %state%] where state encodes a single PlaybackPosition (seconds + nanos) wrapped as [[[seconds, nanos]]] — see ArtifactUserState below.
message
orchestration.proto:1734UpsertArtifactUserState (Fxmvse). HAR-verified 2026-04-25 against NotebookLM web UI interactive-audio capture set (22 samples; web UI fires this every ~5s during interactive audio-overview playback to persist the listener's playback position). Wire request: [%context%, %artifact_id%, %state%] - context: standard project_context request envelope - artifact_id: UUID of the artifact (audio overview) - state: ArtifactUserState — encodes [[[seconds, nanos]]] The same ArtifactUserState value is also emitted inline in each gArtLc (ListArtifacts) artifact tuple at a late field position; that inline copy is what the UI reads on page load.
optional context = 1
string artifact_id = 2
optional state = 3
message
orchestration.proto:1744UpsertArtifactUserStateResponse echoes the persisted state. Wire response: [[[[seconds, nanos]]]] — a single ArtifactUserState value (which is itself [[[seconds, nanos]]]) wrapped at field 1.
optional state = 1
Service definitions
rpc CreateAccessRequest (, )
sharing.proto:257CreateAccessRequest (n3dkHd). Sent when a non-collaborator opens a shared notebook URL and clicks "Request access". JS-bundle- verified; no HAR yet. TODO(har): trigger by opening a private share link from a logged- in account that lacks access.
message
sharing.proto:118CreateAccessRequest (n3dkHd). Sent when a non-collaborator opens a shared notebook URL and clicks "Request access". wire shape unverified.
string project_id = 1
string requester_message = 2
message
sharing.proto:123string request_id = 1
rpc GetProjectDetails (, )
sharing.proto:243Project sharing
message
sharing.proto:35GetProjectDetailsRequest. JS bundle confirms the canonical service name: JFMDGd → /LabsTailwindSharingService.GetProjectDetails. The Go-side field name `share_id` is historical; HAR shows the wire accepts the project_id (not a share-link slug). Captured against 12+ notebooks in NotebookLM web UI captures (2026-04-06..2026-04-23). Wire request: [project_id, [2]] [1] = [2] is an opaque mode flag (constant across all observed calls); other modes might surface different response payload shapes but have not been observed.
string share_id = 1
Field is named share_id for backwards compatibility with existing Go callers (api.Client.GetProjectDetails); on the wire this is the project UUID.
message
sharing.proto:68ProjectDetails. The captured response in our corpus carries only the collaborators payload, not the title/emoji/thumbnail that the fields below also model. The legacy fields are retained for backward compatibility with consumers of the generated protos and may populate under request modes other than [2] (none observed yet). HAR-verified shape: [ [<owner_entry>, <collaborator_entry>, ...], <flags|null>, // [true,true] when fully public, null o/w 1000, // opaque limit true, null, null, [3, true, true], // permissions blob (newer captures only) ] Entry per user: [email, role_int, [], [display_name, avatar_url]] role_int 1 = OWNER (the only role observed in single-user captures) api.Client.parseProjectDetailsResponse (client.go:4463) extracts only OwnerName + IsPublic.
string project_id = 1
string title = 2
string emoji = 3
string owner_name = 4
populated from owner entry's display_name
bool is_public = 5
populated from response [1] flags array
optional shared_at = 6
repeated sources = 7
repeated collaborators = 8
Collaborator list reflects the wire's primary payload.
message
orchestration.proto:421Used as response type in: LabsTailwindOrchestrationService.GetOrCreateAccount, LabsTailwindOrchestrationService.MutateAccount
Used as field type in:
string account_id = 1
string email = 2
optional settings = 3
message
orchestration.proto:427Used in:
bool email_notifications = 1
string default_project_emoji = 2
Used in:
AGENT_COMMS_MESSAGE_TYPE_UNSPECIFIED = 0
USER_UTTERANCE = 1
Real-time text transcript of user's speech
AGENT_UTTERANCE = 2
Real-time text transcript of AI host's speech
TTS_EVENT = 3
Text-to-speech lifecycle hooks
SEND_AUDIO_EVENT = 4
Audio payload transmission triggers
GROUNDED_AGENT_CUSTOM_MESSAGE = 5
Control frame observed in live captures
PLAYBACK_EVENT = 6
Client-side media playback state sync
MICROPHONE_EVENT = 7
Microphone active/muted state sync
STATUS_MESSAGE = 8
Connection diagnostics and state updates
message
orchestration.proto:1255AgentCommsPayload reconstructs the typed DataChannel payload at field 4. The sub-field numbers match AgentCommsMessageType values.
Used in:
optional user_utterance = 1
optional agent_utterance = 2
optional tts_event = 3
optional send_audio_event = 4
optional grounded_agent_custom_message = 5
optional playback_event = 6
optional microphone_event = 7
optional status_message = 8
message
orchestration.proto:1225AgentCommsUserMessage is the protobuf transmitted over the WebRTC DataChannel for real-time bidirectional UI and transcript synchronization.
AgentCommsMessageType type = 1
string content = 2
optional payload = 4
Field 4 carries the typed event payload observed in live captures.
message
orchestration.proto:1272Used in:
int32 speaker_id = 1
repeated string speakers = 2
string transcript_text = 3
bool is_final = 4
string utterance_id = 5
message
orchestration.proto:79Used in:
string app_id = 1
string name = 2
string description = 3
message
orchestration.proto:23Used as response type in: LabsTailwindOrchestrationService.CreateArtifact, LabsTailwindOrchestrationService.GenerateArtifact, LabsTailwindOrchestrationService.GetArtifact, LabsTailwindOrchestrationService.RenameArtifact, LabsTailwindOrchestrationService.UpdateArtifact
Used as field type in: , , , ,
string artifact_id = 1
string project_id = 2
ArtifactType type = 3
repeated sources = 4
ArtifactState state = 5
optional note = 7
Note is a special type of Source
optional audio_overview = 8
optional tailored_report = 9
optional app = 10
optional video_overview = 11
Video overview artifact
message
orchestration.proto:57Used in:
optional source_id = 1
repeated text_fragments = 2
Used in:
ARTIFACT_STATE_UNSPECIFIED = 0
ARTIFACT_STATE_CREATING = 1
ARTIFACT_STATE_READY = 2
ARTIFACT_STATE_FAILED = 3
ARTIFACT_STATE_SUGGESTED = 4
ARTIFACT_STATE_7 = 7
ARTIFACT_STATE_8 = 8
ARTIFACT_STATE_9 = 9
message
orchestration.proto:1648One suggestion pair. Pass description (optionally edited) as the instructions argument to CreateAudioOverview / CreateUniversalArtifact.
Used in:
string title = 1
string description = 2
Used in:
ARTIFACT_TYPE_UNSPECIFIED = 0
ARTIFACT_TYPE_NOTE = 1
ARTIFACT_TYPE_AUDIO_OVERVIEW = 2
ARTIFACT_TYPE_VIDEO_OVERVIEW = 3
Video overview (confirmed from /tmp/notebooklm3.har)
ARTIFACT_TYPE_REPORT = 4
ARTIFACT_TYPE_APP = 5
ARTIFACT_TYPE_8 = 8
message
orchestration.proto:1717ArtifactUserState is the per-user, per-artifact state the orchestration service persists. Today the only observed payload is a single repeated PlaybackPosition recording the user's last playback position in an audio overview; the field is repeated to leave room for additional markers (resume points, chapter offsets) that the UI may emit later. Wire shape (HAR-verified 2026-04-25): [[[seconds, nanos]]] That is: ArtifactUserState is a message with field 1 = repeated PlaybackPosition, and a single PlaybackPosition encodes positionally as [seconds, nanos].
Used in: , ,
repeated playback_position = 1
message
orchestration.proto:1548AudioFormat captured kinds (HAR 2026-04-19+): 1 = "Deep Dive" — two-host conversation 2 = "Brief" — bite-sized overview 3 = "Critique" — expert review w/ feedback 4 = "Debate" — two-host opposing perspectives
Used in:
int32 id = 1
string name = 2
string description = 3
Audio length options (confirmed from /tmp/notebooklm2.har analysis)
Used in:
AUDIO_LENGTH_UNSPECIFIED = 0
AUDIO_LENGTH_SHORT = 1
Shorter audio overview
AUDIO_LENGTH_DEFAULT = 2
~10-15 minutes
AUDIO_LENGTH_LONG = 3
~15-20 minutes (longer)
message
notebooklm.proto:144Used as response type in: LabsTailwindOrchestrationService.CreateAudioOverview, LabsTailwindOrchestrationService.CreateAudioOverviewLegacy, LabsTailwindOrchestrationService.GetAudioOverview
Used as field type in:
string status = 1
string content = 2
string instructions = 3
string audio_id = 4
string audio_url = 5
string title = 6
Audio style types (confirmed from sqTeoe RPC in HAR analysis)
Used in: ,
AUDIO_TYPE_UNSPECIFIED = 0
AUDIO_TYPE_DEEP_DIVE = 1
"A lively conversation between two hosts, unpacking and connecting topics"
AUDIO_TYPE_BRIEF = 2
"A bite-sized overview to help you grasp the core ideas quickly"
AUDIO_TYPE_CRITIQUE = 3
"An expert review offering constructive feedback"
AUDIO_TYPE_DEBATE = 4
"A thoughtful debate illuminating different perspectives"
message
rpc_extensions.proto:70Encoding hints for batchexecute format
(message has no fields)
How to encode arrays
ARRAY_DEFAULT = 0
ARRAY_NESTED = 1
[[item1], [item2]]
ARRAY_FLAT = 2
[item1, item2]
ARRAY_WRAPPED = 3
[[[item1, item2]]]
How to handle empty/zero values
EMPTY_VALUE_DEFAULT = 0
EMPTY_VALUE_NULL = 1
EMPTY_VALUE_OMIT = 2
EMPTY_VALUE_EMPTY_ARRAY = 3
message
orchestration.proto:1509Used in:
string source_id = 1
string title = 2
string url = 3
message
orchestration.proto:1490Used in:
string url = 1
string title = 2
string content = 3
content holds inline markdown when this source is a note/text import (type=3). Leave empty for URL imports (type=2).
int32 source_type = 4
source_type matches the trailing enum int in the wire tuple: 2 = URL (url + title populated) 3 = NOTE (title + content populated)
message
orchestration.proto:257Used in: , , ,
int32 start = 1
int32 end = 2
message
orchestration.proto:273Used in:
double confidence = 1
repeated ranges = 2
repeated excerpts = 3
message
orchestration.proto:268Used in:
optional range = 1
repeated segments = 2
message
orchestration.proto:262Used in:
optional range = 1
string text = 2
bool emphasized = 3
message
orchestration.proto:251Used in:
string conversation_id = 1
string message_id = 2
int32 sequence_number = 3
message
orchestration.proto:284Used in:
string text = 1
int32 type = 2
message
notebooklm.proto:35Used in:
int32 goal = 1
string custom_prompt = 2
message
orchestration.proto:1215Used in:
string content = 1
int32 role = 2
1 = user, 2 = assistant
message
orchestration.proto:279Used in:
optional range = 1
repeated int32 source_indices = 2
message
notebooklm.proto:44Used in: ,
optional goal = 1
optional response_length = 2
message
orchestration.proto:17Used in: ,
string project_id = 1
Context information, structure inferred from usage
repeated string source_ids = 2
message
orchestration.proto:1443Used in:
string research_id = 1
string conversation_id = 2
int32 mode = 3
1 = fast, 5 = deep
int32 state = 4
1 = running, 2 = complete, 5 = deleted
string query = 5
string plan = 6
bytes main_blob = 7
opaque report+sources payload
message
notebooklm.proto:167Used in:
string content = 1
message
orchestration.proto:1865Used in:
string item_id = 1
string title = 2
string description = 3
string thumbnail_url = 4
message
orchestration.proto:344Used in:
string title = 1
repeated sources = 2
string project_id = 3
string emoji = 4
optional metadata = 6
optional chatbot_config = 8
optional presentation = 15
message
orchestration.proto:333Used in:
string url = 1
message
orchestration.proto:337Used in:
bool curated = 1
repeated images = 2
string provider = 3
string description = 4
message
sharing.proto:216Used in:
int32 max_length = 1
float temperature = 2
bool include_sources = 3
message
orchestration.proto:212Used in:
string content = 1
Wire shape: [content, null, role]
int32 role = 3
1 = user, 2 = assistant
message
orchestration.proto:218Used in:
int32 mode = 1
Observed default request options: [2, null, [1], [1]]
repeated int32 citation_modes = 3
repeated int32 follow_up_modes = 4
message
notebooklm.proto:88Used in:
string document_id = 1
message
orchestration.proto:1244Used in:
bytes raw = 1
Guide type for GenerateNotebookGuide (confirmed from /tmp/notebooklm3.har analysis)
Used in:
GUIDE_TYPE_UNSPECIFIED = 0
GUIDE_TYPE_OUTLINE = 1
Text outline
GUIDE_TYPE_MIND_MAP = 2
Mind map visualization
message
sharing.proto:128Guidebook-related messages
Used as response type in: LabsTailwindGuidebooksService.GetGuidebook
Used as field type in: , ,
string guidebook_id = 1
string project_id = 2
string title = 3
string content = 4
GuidebookStatus status = 5
optional published_at = 6
message
sharing.proto:194Used in:
int32 view_count = 1
int32 share_count = 2
optional last_viewed = 3
message
sharing.proto:187Used in:
string section_id = 1
string title = 2
string content = 3
int32 order = 4
Used in:
GUIDEBOOK_STATUS_UNSPECIFIED = 0
GUIDEBOOK_STATUS_DRAFT = 1
GUIDEBOOK_STATUS_PUBLISHED = 2
GUIDEBOOK_STATUS_ARCHIVED = 3
message
orchestration.proto:1326Used in:
repeated string urls = 1
stun: and turn: URIs
string username = 2
empty for STUN entries
string credential = 3
empty for STUN entries
message
orchestration.proto:1692Label is one autolabel cluster. The trailing "" in the wire tuple appears to be reserved for a per-label description (always empty in captures); not modeled here until a populated case is observed.
Used in: , ,
string name = 1
e.g. "Generated Code", "Testing", "RPC and Networking"
string label_id = 2
server-assigned UUID
repeated string source_ids = 3
members of this cluster
message
notebooklm.proto:351Used in:
string title = 1
message
orchestration.proto:1301Used in:
int32 status_code = 1
message
orchestration.proto:1829Used in:
string model_id = 1
string display_name = 2
bool default_for_chat = 3
message
notebooklm.proto:132Used as response type in: LabsTailwindOrchestrationService.CreateNote, LabsTailwindOrchestrationService.MutateNote
Used as field type in:
string note_id = 1
string content_text = 2
string title = 5
string rich_text = 6
repeated int32 note_type = 7
message
orchestration.proto:405Used in:
string content = 1
string title = 2
repeated string tags = 3
message
orchestration.proto:1297Used in:
repeated string states = 1
message
orchestration.proto:1701PlaybackPosition is a positional (seconds, nanos) tuple that mirrors google.protobuf.Duration's two int fields. Used inside ArtifactUserState to record the listener's place in an interactive audio overview.
Used in:
int64 seconds = 1
int32 nanos = 2
message
notebooklm.proto:14Used as response type in: LabsTailwindOrchestrationService.AddSources, LabsTailwindOrchestrationService.CopyProject, LabsTailwindOrchestrationService.CreateProject, LabsTailwindOrchestrationService.GetProject, LabsTailwindOrchestrationService.MutateProject
Used as field type in: ,
string title = 1
repeated sources = 2
string project_id = 3
string emoji = 4
optional metadata = 6
optional chatbot_config = 8
message
sharing.proto:83ProjectCollaborator captures the actual per-user wire entry. role_int observed values: 1 = OWNER. Other roles will appear once a notebook with multiple collaborators is captured.
Used in:
string email = 1
int32 role = 2
string display_name = 3
string avatar_url = 4
message
notebooklm.proto:23Used in: ,
int32 user_role = 1
bool session_active = 2
or similar
optional create_time = 9
bool something = 3; field 4 reserved/unknown field 5 reserved/unknown
optional modified_time = 6
or similar
int32 type = 7
bool is_starred = 8
message
sharing.proto:167Used in:
bool is_public = 1
repeated string tags = 2
message
orchestration.proto:68Used in:
string title = 1
string content = 2
repeated sections = 3
message
orchestration.proto:306Used in:
string title = 1
string description = 2
repeated string source_ids = 4
field 3 is null in observed responses
string prompt = 5
int32 count = 6
message
notebooklm.proto:40Used in:
int32 value = 1
message
orchestration.proto:74Used in:
string title = 1
string content = 2
message
orchestration.proto:1292Used in:
int32 trigger_type = 1
string utterance_id = 2
Additional message not in sharing.proto
bool public = 1
repeated string emails = 2
Used in: , ,
bool is_public = 1
repeated string allowed_emails = 2
bool allow_comments = 3
bool allow_downloads = 4
optional expiry_time = 5
message
notebooklm.proto:53Used as response type in: LabsTailwindOrchestrationService.LoadSource, LabsTailwindOrchestrationService.MutateSource, LabsTailwindOrchestrationService.RefreshSource
Used as field type in: , , , ,
optional source_id = 1
string title = 2
optional metadata = 3
optional settings = 4
repeated warnings = 5
message
notebooklm.proto:49Used in: ,
string source_id = 1
message
orchestration.proto:364Used in:
string title = 1
For text sources
string content = 2
string base64_content = 3
For file upload
string filename = 4
string mime_type = 5
string url = 6
For URL sources
string youtube_video_id = 7
For YouTube
SourceType source_type = 8
message
notebooklm.proto:110SourceIssue.Reason reason = 1
Used in:
REASON_UNSPECIFIED = 0
REASON_TEMPORARY_SERVER_ERROR = 1
REASON_PERMANENT_SERVER_ERROR = 2
REASON_INVALID_SOURCE_ID = 3
REASON_SOURCE_NOT_FOUND = 4
REASON_UNSUPPORTED_MIME_TYPE = 5
REASON_YOUTUBE_ERROR_GENERIC = 6
REASON_YOUTUBE_ERROR_UNLISTED = 7
REASON_YOUTUBE_ERROR_PRIVATE = 8
REASON_YOUTUBE_ERROR_MEMBERS_ONLY = 9
REASON_YOUTUBE_ERROR_LOGIN_REQUIRED = 10
REASON_GOOGLE_DOCS_ERROR_GENERIC = 11
REASON_GOOGLE_DOCS_ERROR_NO_ACCESS = 12
REASON_GOOGLE_DOCS_ERROR_UNKNOWN = 13
REASON_DOWNLOAD_FAILURE = 14
REASON_UNKNOWN = 15
message
notebooklm.proto:61Used in:
oneof metadata_type
google_docs = 1
youtube = 6
optional last_update_time_seconds = 2
optional last_modified_time = 3
SourceType source_type = 5
google.internal.labs.tailwind.common.v1.RevisionData revision_data = 4;
SourceSettings.SourceStatus status = 7
message
sharing.proto:228Used in:
string source_id = 1
string title = 2
string excerpt = 3
message
notebooklm.proto:99Used in:
SourceSettings.SourceStatus status = 2
google.internal.labs.tailwind.common.v1.SourceIssue reason = 3;
Used in: ,
SOURCE_STATUS_UNSPECIFIED = 0
SOURCE_STATUS_ENABLED = 1
SOURCE_STATUS_DISABLED = 2
SOURCE_STATUS_ERROR = 3
message
sharing.proto:90Used in:
string source_id = 1
string title = 2
SourceType source_type = 3
Used in: , ,
SOURCE_TYPE_UNSPECIFIED = 0
SOURCE_TYPE_UNKNOWN = 1
SOURCE_TYPE_GOOGLE_DOCS = 2
SOURCE_TYPE_GOOGLE_SLIDES = 3
SOURCE_TYPE_TEXT = 4
SOURCE_TYPE_WEB_PAGE = 5
SOURCE_TYPE_LOCAL_FILE = 6
SOURCE_TYPE_GOOGLE_SHEETS = 7
SOURCE_TYPE_SHARED_NOTE = 8
SOURCE_TYPE_YOUTUBE_VIDEO = 9
message
orchestration.proto:1248Used in:
string text = 1
Field 1 carries the human-readable status string when present.
message
orchestration.proto:1285Used in:
int32 event_type = 1
string utterance_id = 2
int32 segment_idx = 3
optional timestamp = 4
message
orchestration.proto:1280Used in:
int64 epoch_sec = 1
int32 nanos = 2
message
orchestration.proto:62Used in:
string text = 1
int32 start_offset = 2
int32 end_offset = 3
message
orchestration.proto:1266Used in:
string transcript = 3
bool is_final = 4
string utterance_id = 5
message
notebooklm.proto:153Used as response type in: LabsTailwindOrchestrationService.CreateVideoOverview
Used as field type in:
string status = 1
string content = 2
string instructions = 3
string video_id = 4
string video_url = 5
string title = 6
int32 style = 7
Video style (1=autoselect, 2=classic, 3=whiteboard)
Video style options (confirmed from /tmp/notebooklm3.har analysis)
Used in:
VIDEO_STYLE_UNSPECIFIED = 0
VIDEO_STYLE_AUTOSELECT = 1
Let system choose the best style
VIDEO_STYLE_CLASSIC = 2
Classic presentation style
VIDEO_STYLE_WHITEBOARD = 3
Whiteboard-style presentation
message
notebooklm.proto:93Used in:
string youtube_url = 1
string video_id = 2