Mengelola ringkasan audio notebook Anda (API)

Setelah membuat notebook dan menambahkan sumber data ke dalamnya, Anda dapat membuat ringkasan audio notebook secara terprogram. Dalam satu waktu, notebook tertentu hanya dapat memiliki satu ringkasan audio. Halaman ini menjelaskan cara membuat dan menghapus ringkasan audio.

Perbedaan antara ringkasan audio dan podcast

Ringkasan audio berbeda dengan podcast dalam hal berikut:

  • Ringkasan audio harus dikaitkan dengan notebook yang telah ditambahkan sumber data. Di sisi lain, podcast dapat dibuat tanpa notebook NotebookLM Enterprise, lisensi Gemini Enterprise, atau penyimpanan data. Untuk membuat podcast, Anda hanya memerlukan project yang diaktifkan Google Cloud dan peran Pengguna Podcast API.
  • Untuk membuat ringkasan audio, panggil metode notebooks.audioOverview. Untuk membuat podcast, panggil metode podcasts—API mandiri.

Membuat ringkasan audio

Untuk membuat ringkasan audio konten di notebook Anda, panggil notebooks.audioOverviews.create metode. Karena Anda hanya dapat memiliki satu ringkasan audio per notebook, metode ini hanya berhasil jika notebook tidak memiliki ringkasan audio.

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"
  }

Ganti kode berikut:

  • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
    • us untuk multi-region Amerika Serikat
    • eu untuk multi-region Uni Eropa
    • global untuk lokasi Global
    Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
  • PROJECT_NUMBER: nomor Google Cloud project Anda.
  • LOCATION: lokasi geografis penyimpanan data Anda, seperti global. Untuk mengetahui informasi selengkapnya, lihat Lokasi.
  • NOTEBOOK_ID: ID unik notebook.
  • SOURCE_ID: ID sumber berdasarkan sumber yang ringkasan audionya ingin Anda buat. sourceIdsfield adalah array opsional; jika Anda tidak menentukan ID sumber, semua sumber di notebook akan digunakan. Untuk mengetahui informasi tentang ID sumber, lihat Menambahkan dan mengelola sumber data di notebook (API).
  • EPISODE_FOCUS: string yang menjelaskan topik atau konten mana yang harus ditandai dalam ringkasan audio.
  • LANGUAGE_CODE: kode bahasa yang digunakan untuk meminta ringkasan audio.

Jika permintaan berhasil, Anda akan mendapatkan respons JSON yang mirip dengan yang berikut ini. Respons ini menunjukkan bahwa pembuatan ringkasan audio sedang berlangsung.

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

Proses pembuatan ringkasan audio memerlukan waktu beberapa menit.

Memverifikasi ringkasan audio yang dibuat

Untuk memverifikasi ringkasan audio yang dibuat, lakukan hal berikut:

  1. Buka notebook Anda. Untuk mengetahui informasi selengkapnya, lihat Mengakses notebook yang dibuat.

  2. Di Studio notebook Anda, klik Load untuk memuat percakapan. Proses pemuatan ringkasan memerlukan waktu beberapa saat.

    Di studio, Anda dapat mengelola ringkasan audio dengan tugas seperti mengubah kecepatan pemutaran dan mendownload atau menghapus file ringkasan audio.

Menghapus ringkasan audio

Untuk menghapus ringkasan audio yang ada, panggil notebooks.audioOverviews.delete metode.

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" \

Ganti kode berikut:

  • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
    • us untuk multi-region Amerika Serikat
    • eu untuk multi-region Uni Eropa
    • global untuk lokasi Global
    Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
  • PROJECT_NUMBER: nomor Google Cloud project Anda.
  • LOCATION: lokasi geografis penyimpanan data Anda, seperti global. Untuk mengetahui informasi selengkapnya, lihat Lokasi.
  • NOTEBOOK_ID: ID unik notebook.

Jika permintaan berhasil, Anda akan mendapatkan JSON kosong.