Menanggapi acara dari Google Meet

Dokumen ini menjelaskan cara menerima dan merespons peristiwa Google Meet dari Google Cloud Pub/Sub.

Acara Meet mewakili aktivitas atau perubahan pada resource Meet, seperti membuat rapat baru. Anda dapat menggunakan peristiwa untuk memahami apa yang terjadi, lalu mengambil tindakan, atau merespons dengan cara yang bermakna bagi pengguna Anda.

Berikut beberapa contoh cara menggunakan peristiwa:

  • Mengamati dan merespons perubahan dalam rapat, seperti saat rapat dimulai atau berakhir.

  • Melacak siapa yang menghadiri rapat untuk tujuan peraturan atau pelatihan.

  • Mendengarkan transkrip rapat sehingga konten file dapat diuraikan dan dicatat ke dalam CRM atau database.

Cara kerja acara

Setiap kali terjadi sesuatu di Google Meet, resource Google Meet REST API akan dibuat atau diperbarui. Meet menggunakan peristiwa untuk mengirimkan informasi ke aplikasi Anda tentang jenis aktivitas yang terjadi, dan resource Meet REST API yang terpengaruh.

Meet mengategorikan acara menurut jenis. Jenis peristiwa membantu Anda memfilter dan menerima hanya jenis informasi yang Anda butuhkan, serta memungkinkan Anda menangani aktivitas serupa dengan cara yang sama.

Contoh berikut menunjukkan cara aktivitas di Meet memengaruhi resource Meet REST API terkait, dan jenis peristiwa yang diterima aplikasi Meet Anda:

Aktivitas Resource REST API Meet Jenis peristiwa
Pengguna bergabung ke ruang rapat. Resource ConferenceRecord dibuat. Rekor konferensi baru

Menerima data peristiwa dari Google Meet

Untuk menerima data peristiwa, aplikasi Anda dapat melakukan salah satu hal berikut:

Tabel berikut menjelaskan perbedaan dan alasan untuk berlangganan peristiwa versus membuat kueri untuk peristiwa tersebut:

Berlangganan peristiwa Kueri data
Kasus penggunaan
  • Memproses atau merespons peristiwa secara real time.
  • Pantau perubahan pada resource untuk meningkatkan performa aplikasi Anda.
  • Mengambil data secara manual.
  • Mengambil semua data dari Meet (karena gangguan atau langganan tidak aktif).
API Google Workspace Events API Meet REST API
Sumber peristiwa Rekor liga dan pengguna Ruang dan catatan konferensi
Acara yang didukung Rekaman konferensi

Untuk mengetahui daftar jenis peristiwa yang didukung, lihat Jenis peristiwa untuk membuat langganan dalam dokumentasi Google Workspace Events API. 		Rekaman ruang dan konferensi

Untuk mengetahui daftar endpoint yang didukung, lihat resource Space dan resource ConferenceRecord dalam dokumentasi Meet REST API.
Format peristiwa Pesan Google Cloud Pub/Sub, diformat sesuai dengan spesifikasi CloudEvent. Untuk mengetahui detailnya, lihat Struktur peristiwa Google Workspace. Resource Meet REST API (Space dan ConferenceRecord)
Data peristiwa String berenkode Base64 dengan atau tanpa data resource. Untuk contoh payload, lihat Data peristiwa. Payload JSON yang berisi data resource. Untuk contoh payload, lihat resource ConferenceRecord dalam dokumentasi referensi.

Batasan
  • Tamu undangan Kalender dan peserta lain yang diundang ke konferensi hanya dapat menerima acara berikut: google.workspace.meet.conference.v2.started dan google.workspace.meet.transcript.v2.fileGenerated.