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.

Contoh cara ruang rapat baru memicu peristiwa.
Gambar 1. Pengguna membuat ruang rapat, yang akan membuat resource Space. Kemudian, Meet akan membuat acara yang berisi data tentang ruang rapat baru.

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.

Contoh: Mengambil peristiwa tentang peserta dalam 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. Kemudian, Anda bisa mendapatkan info tentang peristiwa ini menggunakan metode subscribe atau query.

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 ke 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 setiap aktivitas, seperti mengetahui kapan peserta bergabung atau keluar dari konferensi aktif.

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

Membuat kueri untuk acara terbaru

Daripada 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 membuat kueri untuk peristiwa ruang rapat menggunakan Meet REST API.

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

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

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.