Menanggapi acara dari Google Meet

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

Peristiwa 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.

Berikut beberapa contoh cara Anda dapat menggunakan peristiwa:

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

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

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

Cara kerja peristiwa

Setiap kali sesuatu terjadi 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.

Contoh cara ruang pertemuan baru memicu peristiwa.
Gambar 1. Pengguna membuat ruang rapat, yang membuat a Space resource. Meet kemudian membuat peristiwa yang berisi data tentang ruang rapat baru.

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

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

Aktivitas Resource Meet REST API Jenis peristiwa
Pengguna bergabung ke ruang rapat. Resource ConferenceRecord dibuat. Catatan 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 dibandingkan mengirim kueri untuk peristiwa:

Berlangganan peristiwa Mengirim kueri untuk data
Kasus penggunaan
  • Memproses atau merespons peristiwa secara real time.
  • Memantau 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 Catatan konferensi dan pengguna Ruang dan catatan konferensi
Peristiwa yang didukung Catatan konferensi

Untuk mengetahui daftar jenis peristiwa yang didukung, lihat Jenis peristiwa untuk membuat langganan di dokumentasi Google Workspace Events API. 		Ruang dan catatan konferensi

Untuk mengetahui daftar endpoint yang didukung, lihat Space resource dan ConferenceRecord resource di dokumentasi Meet REST API.
Format peristiwa Pesan Google Cloud Pub/Sub, yang 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 mengetahui contoh payload, lihat Data peristiwa. Payload JSON yang berisi data resource. Untuk mengetahui contoh payload, lihat resource ConferenceRecord di dokumentasi referensi.

Contoh: Mengambil peristiwa tentang peserta di ruang rapat

Dalam contoh ini, aplikasi Meet ingin menerima informasi tentang perubahan peserta di ruang rapat. Di ruang rapat, peserta bergabung ke konferensi aktif, yang mengisi ParticipantSession resource dan memicu peristiwa baru. Anda kemudian bisa mendapatkan info tentang peristiwa ini menggunakan metode berlangganan atau kueri.

Berlangganan peristiwa

Untuk menerima peristiwa secara real time, aplikasi Meet memanggil metode Google Workspace Events API subscriptions.create untuk berlangganan ruang rapat untuk semua jenis peristiwa. Setelah membuat langganan, aplikasi Meet dapat mulai menerima peristiwa.

Aplikasi Meet yang berlangganan peristiwa peserta menggunakan Google Workspace Events API.
Gambar 2. Aplikasi Meet menerima peristiwa peserta melalui langganan menggunakan Google Workspace Events API.

Pada gambar 2, aplikasi Meet memiliki langganan aktif ke ruang rapat, sehingga aplikasi menerima peristiwa setiap kali sesi peserta berubah di ruang rapat. Aplikasi Meet kemudian dapat merespons secara real time ke salah satu aktivitas, seperti mengetahui kapan peserta bergabung atau meninggalkan konferensi aktif.

Untuk mempelajari cara membuat langganan menggunakan Google Workspace Events API, lihat dokumentasi Google Workspace Events API.

Mengirim kueri untuk peristiwa terbaru

Selain menerima peristiwa saat terjadi, aplikasi Meet juga dapat memanggil Meet REST API untuk mencantumkan peristiwa ruang rapat terbaru yang terkait dengan aktivitas peserta.

Aplikasi Meet yang membuat kueri untuk peristiwa peserta menggunakan Meet REST API.
Gambar 3. Aplikasi Meet menerima peristiwa peserta terbaru dengan mengirim kueri untuk peristiwa ruang rapat menggunakan Meet REST API.

Pada gambar 3, aplikasi Meet memanggil Meet REST API conferenceRecords.participants.participantSessions.list metode setelah semua aktivitas sesi peserta terjadi. Meet REST API menampilkan daftar resource ParticipantSession yang mewakili setiap perubahan. Aplikasi Meet kemudian dapat memproses atau merespons berdasarkan aktivitas terbaru, seperti membuat daftar peserta yang bergabung dan meninggalkan konferensi.

Untuk mengirim kueri untuk peristiwa menggunakan Meet REST API, lihat Mencantumkan semua sesi peserta.

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