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 memiliki sumber data yang ditambahkan ke dalamnya. Di sisi lain, podcast dapat dibuat tanpa notebook Gemini Notebook Enterprise, lisensi Gemini Enterprise, atau penyimpanan data. Untuk membuat podcast, Anda hanya memerlukan project Google Cloudyang diaktifkan dan peran Podcast API User.
  • 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 hanya berhasil jika notebook belum 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 AS
    • 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 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 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 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 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"
    }
  }

Perlu waktu beberapa menit untuk membuat ringkasan audio.

Memverifikasi ringkasan audio yang dibuat

Untuk memverifikasi ringkasan audio yang dihasilkan, 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. 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. Tentukan salah satu nilai berikut:
    • us untuk multi-region AS
    • 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.