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 Cloud yang diaktifkan dan peran Podcast API User.
  • Untuk membuat ringkasan audio, panggil metode notebooks.audioOverview. Untuk membuat podcast, panggil metode podcasts—API mandiri.

Menggunakan endpoint multi-regional AS

Jika langganan Gemini Notebook Enterprise Anda berada di multi-region AS, Anda dapat mengirim permintaan di halaman ini ke endpoint multi-regional AS, discoveryengine.us.rep.googleapis.com. Endpoint multi-regional memproses permintaan Anda dan menghentikan TLS dalam multi-region, sehingga data permintaan Anda tetap berada di AS saat dalam pengiriman. Penggunaan endpoint ini tidak mengubah tempat penyimpanan notebook Anda. Untuk informasi selengkapnya, lihat Ringkasan endpoint API regional dan multi-regional dalam panduan keamanan Google Cloud.

Untuk menggunakan endpoint multi-regional AS, buat perubahan berikut pada setiap URL permintaan di halaman ini:

  1. Ganti host ENDPOINT_LOCATION-discoveryengine.googleapis.com dengan discoveryengine.us.rep.googleapis.com.

  2. Tetapkan LOCATION ke us.

Bagian lain dari setiap permintaan tetap sama. Untuk mempelajari cara memilih multi-region langganan Anda, lihat Mendapatkan langganan. Untuk mengetahui daftar endpoint layanan regional dan multi-regional, lihat Endpoint layanan regional dan multi-regional dalam panduan Virtual Private Cloud.

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 ingin Anda gunakan untuk membuat 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 disoroti 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: nomor 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.