Mengelola ringkasan audio notebook Anda (API)

Setelah membuat notebook dan menambahkan sumber data ke dalamnya, Anda dapat membuat ringkasan audio notebook secara terprogram. Pada 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 dari podcast dalam hal berikut:

• Ringkasan audio harus dikaitkan dengan notebook yang telah ditambahkan sumber datanya. Di sisi lain, podcast dapat dibuat tanpa notebook NotebookLM Enterprise, lisensi Gemini Enterprise, atau penyimpanan data. Untuk membuat podcast, yang Anda butuhkan hanyalah 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.

Buat ringkasan audio

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

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. Tetapkan 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: jumlah project Google Cloud Anda.
• LOCATION: lokasi geografis penyimpanan data Anda, seperti global. Untuk mengetahui informasi selengkapnya, lihat Lokasi.
• NOTEBOOK_ID: ID unik notebook.
• SOURCE_ID: ID sumber yang menjadi dasar pembuatan ringkasan audio. sourceIdsfield adalah array opsional; jika Anda tidak menentukan ID sumber, semua sumber dalam 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 disorot dalam ringkasan audio.
• LANGUAGE_CODE: kode bahasa yang digunakan untuk meminta ringkasan audio.

Jika permintaan berhasil, Anda akan mendapatkan respons JSON yang mirip dengan berikut. 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 langkah-langkah berikut:

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

2. Di Studio notebook Anda, klik Muat untuk memuat percakapan. Perlu waktu beberapa saat untuk memuat ringkasan.

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

Ganti kode berikut:

• ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tetapkan 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: jumlah project Google Cloud 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.