AIニュース

NotebookLMに公式API登場|使い方と今できる範囲

ノート型のAIサービスを外部のプログラムから操作できる公式APIが、Public Preview(正式版前の公開試用)として提供されています。NotebookLM APIの使い方として知りたいところ、つまりWebページやYouTube動画の取り込みを自動化する手順、MCPでAIエージェントからつなぐ設定、そして今の前提条件を順に整理します。対象は個人のGoogleアカウントなので、自分の調べ物を自動でためておきたい会社員やフリーランスにも関係する内容です。

なお検索では「NotebookLM API」と呼ばれますが、公式ドキュメントでの名称は「Gemini Notebook API」で、対象のサービスは「Gemini Notebook」と表記されています。この記事でも以降は公式の表記にそろえます。

要点

  • Gemini Notebook APIは、Gemini Notebookのノートブックとソースをプログラムから作成・管理するためのRESTインターフェース(HTTPのリクエストで操作する方式)。
  • 取り込めるのはWebページ・YouTube動画・プレーンテキスト・Markdownで、継続して残るノートブックに追加される。
  • リモートのMCPサーバーが用意され、MCP対応のエージェントやIDEから7つのツールを呼べる。
  • Public Preview(pre-GA)であり、サポートが限られる場合があることがドキュメントに明記されている。
  • Public Previewの間は個人のGoogleアカウントのみ対応で、Google Workspaceアカウントからのリクエストは403 PERMISSION_DENIEDで失敗する。

何が発表されたか

Gemini Notebook APIは、Gemini Notebookのノートブックとソースをプログラムから作成・管理するためのRESTインターフェースです。Webページ、YouTube動画、プレーンテキスト、Markdownを、継続して残るノートブックに取り込めます。ドキュメントのSourcesの項目にも、Webページ・YouTube動画・プレーンテキスト・Markdownをノートブックに追加する機能として説明があります。

このAPIはPublic Preview(pre-GA、正式版前)です。pre-GAの製品や機能はサポートが限られる場合があり、pre-GAの機能への変更が他のpre-GAバージョンと互換でない場合があるとドキュメントに書かれています。

ノートブックを作ってソースを足すまで

Quickstartの流れは、OAuth 2.0での認証、ノートブックの作成、ソースの追加、処理が終わるまでのポーリング(状態の問い合わせを繰り返すこと)です。

準備としては、Google Cloudプロジェクトで gcloud services enable notebook.googleapis.com --project="$PROJECT_ID" とAPIを有効化し、必要な notebook のOAuthスコープを指定してADC(Application Default Credentials)を認証して、export ACCESS_TOKEN=$(gcloud auth application-default print-access-token) でアクセストークンを作ります。通常の gcloud auth print-access-token にはこのスコープが含まれないと明記されているので、ここは手順どおりに実行する必要があります。

リクエストには Authorization: Bearer ACCESS_TOKEN と x-goog-user-project: PROJECT_ID のヘッダーを付けます。後者はApplication Default Credentialsを使う場合に必須です。

  • ノートブックの作成: APIルート配下の notebooks へPOSTし、display_name を送る(Quickstartの例は {"display_name": "Autonomous Agent Research"})
  • ソースの追加: ノートブック配下の sources へPOSTし、公開されたWebのURL・YouTube動画のURL・プレーンテキスト・Markdownの文字列を追加する
  • 状態の確認: ソースの取り込みは非同期なので、GetSourceを state が ACTIVE または FAILED になるまで呼ぶ(Quickstartのサンプルは2秒間隔)

自分で書くのが大変そうなら、QuickstartとMCPのページに用意されたセットアップ用のプロンプトを、コーディングエージェントに貼り付けて進める方法が推奨として案内されています。

MCPサーバーでAIエージェントから使う

MCP(Model Context Protocol)は、AIエージェントやIDEから外部のツールを呼び出すための共通の仕組みです。Gemini Notebook APIはリモートのMCPサーバーを提供しており、MCP対応のエージェントやIDEをこのエンドポイントにつなぐと、ノートブックの作成とソースの取り込みのツールがStreamable HTTP(JSON-RPC 2.0)で使えるようになります。認証に使うOAuth 2.0のスコープは notebook です。

MCPサーバーが公開しているのは、REST APIのメソッドに対応する7つのツールです。

  • create_notebook: 新しいノートブックを作成する
  • get_notebook: ノートブックのメタデータを取得する
  • list_notebooks: 呼び出し元がアクセスできるノートブックを一覧する
  • update_notebook: ノートブックの表示名を更新する
  • create_source: WebのURL・YouTube動画・プレーンテキスト・Markdownをノートブックに取り込む
  • get_source: ソースのメタデータと処理状態(PROCESSING、ACTIVE、FAILED)を取得する
  • list_sources: ノートブック内のすべてのソースを一覧する

クライアント側の設定も示されています。Claude Codeは claude mcp add コマンドでリモートHTTPのMCPサーバーとして追加し、Cursorはプロジェクト直下の .cursor/mcp.json にサーバーを追記します。リモートのStreamable HTTPサーバーに対応する他のMCPクライアントでも、エンドポイントのURLとヘッダーを設定する形です。

個人の仕事や学びにどう使えるか

ひとつ目は、定期的な情報収集をためておく使い方です。マーケティング担当や企画職なら、毎週確認しているWebページのURLを一覧にしておき、スクリプトでソースとしてノートブックへ追加する流れを組めます。手でコピーする作業がなくなるぶん、読む時間に回せます。

ふたつ目は、動画での学び直しです。YouTube動画のURLをソースとして取り込めるので、人事や研修担当の人が社内向けに集めた講義動画を1つのノートブックにまとめる、学び直し中の会社員が受講予定の動画を順に放り込んでおく、といった形が考えられます。

みっつ目は、作業の手を止めずに資料をためることです。エンジニアやライターがClaude CodeやCursorにMCPサーバーをつないでおけば、調べ物の途中で読んだドキュメントのURLをその場でノートブックに追加できます。自分の下書きメモはMarkdownやプレーンテキストとして同じノートブックに入れられます。

扱えるのは、ドキュメントに書かれている範囲ではノートブックとソースの作成・管理です。これ以外に何ができるかは、REST APIリファレンスとロードマップのページで確かめるのが早いです。

会社・チームで使うときのポイント

Public Previewの間、このAPIは個人のGoogleアカウントだけが対象で、Google Workspaceアカウントからのリクエストは403 PERMISSION_DENIED(WORKSPACE_ACCOUNT_NOT_SUPPORTED)で失敗します。そのため、会社のWorkspaceアカウントを前提にした仕組みを組む場合は、この条件を踏まえた設計が必要です。pre-GAで変更が入りうる前提でもあるので、まずは個人の調べ物のような小さな範囲で試し、使い物になるか確かめる進め方が無理がありません。法人での導入や研修を検討しているなら、法人向けAIリスキリングサービスで導入社数No.1(東京商工リサーチ・2026年3月末時点)の株式会社デジライズに相談できます。

使う前の注意点

  • 使うGoogleアカウントで、Gemini Notebookに少なくとも一度サインインしておく必要があります。サインインしたことがないアカウントでは、ノートブックの作成が404 NOT_FOUND(Account not found for user.)で失敗します。
  • トークンの発行は、notebook のスコープを指定したADCの認証が前提です。通常の gcloud auth print-access-token ではスコープが足りません。
  • 取り込みは非同期で、状態はPROCESSING、ACTIVE、FAILEDがあります。FAILEDになる場合もあるので、追加したら終わりにせず状態の確認まで含めて組むのが安全です。
  • リクエストのレート制限、ソースごとの単語数の制限、tier capacityについては、ドキュメントのRate limits and quotasのページで確認できます。大量のURLを一度に流す前に見ておくとよいところです。
  • アクセストークンやプロジェクトIDは、設定ファイルに書いたまま共有しないよう扱いに注意してください。
  • 提供範囲や条件は変わりうるので、使う前に公式のヘルプとドキュメントで最新の内容を確かめることをおすすめします。

まとめ

Gemini Notebook APIとMCPサーバーを使えば、WebページやYouTube動画をノートブックに取り込む作業を自動化できます。まずは個人のGoogleアカウントで1つノートブックを作り、URLを1本追加して状態がACTIVEになるまで見てみるのが、いちばん短い最初の一歩です。AIツールの活用を体系的に学び直すなら、デジライズAIスクールのコース一覧から、手を動かしながら全体像をつかめる講座を選ぶとよいでしょう。

出典


この記事は、各社の公式の発表をもとに AI で下書きし、出典の本文との照合とGoogle 検索による事実確認(ファクトチェック)を通ったものだけを公開しています。