ノートブックの音声解説を管理する（API）

ノートブックを作成してデータソースを追加したら、ノートブックの音声解説をプログラムで生成できます。一度に 1 つのノートブックに設定できる音声解説は 1 つのみです。このページでは、音声解説の作成と削除の方法について説明します。

音声解説とポッドキャストの違い

音声解説は、次の点でポッドキャストとは異なります。

  • 音声解説は、データソースが追加されたノートブックに関連付ける必要があります。一方、ポッドキャストは、NotebookLM Enterprise ノートブック、Gemini Enterprise ライセンス、データストアなしで生成できます。ポッドキャストを作成するには、有効な Google Cloudプロジェクトと Podcast API ユーザーのロールが必要です。
  • 音声解説を作成するには、notebooks.audioOverview メソッドを呼び出します。ポッドキャストを作成するには、スタンドアロン API である podcasts メソッドを呼び出します。

音声解説を作成する

ノートブックのコンテンツの音声解説を生成するには、notebooks.audioOverviews.create メソッドを呼び出します。ノートブックごとに音声解説は 1 つしか設定できないため、このメソッドはノートブックに既存の音声解説がない場合にのみ成功します。

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews" \
  -d '{
  "sourceIds": [
    {
      "id": "SOURCE_ID"
    }
  ],
  "episodeFocus": "EPISODE_FOCUS",
  "languageCode": "LANGUAGE_CODE"
  }

次のように置き換えます。

  • ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を割り当てます。
    • 米国のマルチリージョンの場合は us-
    • EU のマルチリージョンの場合は eu-
    • グローバル ロケーションの場合は global-
    詳細については、データストアのマルチリージョンを指定するをご覧ください。
  • PROJECT_NUMBER: Google Cloud プロジェクトの数。
  • LOCATION: データストアの地理的位置（global など）。詳細については、ロケーションをご覧ください。
  • NOTEBOOK_ID: ノートブックの固有識別子。
  • SOURCE_ID: 音声解説を生成するソースの ID。sourceIdsfield は省略可能な配列です。ソース ID を指定しない場合、ノートブック内のすべてのソースが使用されます。ソース ID については、ノートブックでデータソースを追加して管理する（API）をご覧ください。
  • EPISODE_FOCUS: 音声解説でハイライト表示する必要があるトピックやコンテンツを説明する文字列。
  • LANGUAGE_CODE: 音声解説がリクエストされた言語コード。

リクエストが成功すると、次のような JSON レスポンスが返されます。このレスポンスは、音声解説の生成が進行中であることを示しています。

  {
    "audioOverview": {
      "status": "AUDIO_OVERVIEW_STATUS_IN_PROGRESS",
      "audioOverviewId": "AUDIO_OVERVIEW_ID",
      "generationOptions": {},
      "name": "AUDIO_OVERVIEW_NAME"
    }
  }

音声解説の生成には数分かかります。

生成された音声解説を確認する

生成された音声解説を確認するには、次の操作を行います。

  1. ノートブックを開きます。詳細については、作成したノートブックにアクセスするをご覧ください。

  2. ノートブックの Studio で、[Load] をクリックして会話を読み込みます。概要の読み込みには少し時間がかかります。

    スタジオでは、再生速度の変更、音声解説ファイルのダウンロードや削除などのタスクで音声解説を管理できます。

音声解説を削除する

既存の音声解説を削除するには、notebooks.audioOverviews.delete メソッドを呼び出します。

REST

curl -X DELETE \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews/default" \

次のように置き換えます。

  • ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を割り当てます。
    • 米国のマルチリージョンの場合は us-
    • EU のマルチリージョンの場合は eu-
    • グローバル ロケーションの場合は global-
    詳細については、データストアのマルチリージョンを指定するをご覧ください。
  • PROJECT_NUMBER: Google Cloud プロジェクトの数。
  • LOCATION: データストアの地理的位置（global など）。詳細については、ロケーションをご覧ください。
  • NOTEBOOK_ID: ノートブックの固有識別子。

リクエストが成功すると、空の JSON が返されます。