Berlangganan acara Google Meet

Halaman ini menjelaskan acara Google Meet yang dapat dibeli langganannya oleh aplikasi Anda menggunakan Google Workspace Events API. Setelah Anda menentukan jenis peristiwa yang diperlukan, buat langganan untuk mulai menerima peristiwa dari Google Meet.

Untuk mempelajari lebih lanjut cara mengembangkan aplikasi untuk Google Meet, lihat ringkasan Google Meet REST API.

Peristiwa Meet yang didukung

Langganan Google Workspace memungkinkan Anda menerima peristiwa tentang jenis perubahan berikut di Meet:

Resource yang dapat Anda pantau untuk peristiwa

Untuk menerima peristiwa, Anda menentukan resource Meet yang akan dipantau, yang disebut resource target langganan.

Google Workspace Events API mendukung resource target berikut untuk Meet:

Resource target Format Batasan (jika ada)
Ruang rapat //meet.googleapis.com/spaces/SPACE

dengan SPACE adalah ID dalam nama resource resource space Meet REST API. Untuk mengetahui detailnya, lihat Cara Meet mengidentifikasi ruang rapat.
Pengguna //cloudidentity.googleapis.com/users/USER

dengan USER adalah ID di kolom signedinUser.user dari resource participant Meet REST API. Untuk mengetahui detailnya, lihat Menangani peserta.

Langganan menerima peristiwa tentang ruang rapat tempat pengguna adalah salah satu dari berikut:

  • Pemilik ruang rapat.
  • Penyelenggara acara Google Kalender yang terkait dengan ruang rapat.

Jenis peristiwa untuk membuat langganan

Saat membuat langganan ke resource Meet, Anda menggunakan kolom eventTypes[] untuk menentukan jenis peristiwa yang ingin Anda terima. Jenis peristiwa diformat sesuai dengan spesifikasi CloudEvents, seperti google.workspace.APPLICATION.RESOURCE.VERSION.ACTION. Misalnya, untuk menerima peristiwa tentang peserta baru dalam konferensi untuk ruang Meet, Anda menentukan jenis peristiwa sebagai google.workspace.meet.participant.v2.joined. Untuk mempelajari lebih lanjut cara kerja peristiwa, lihat Struktur peristiwa Google Workspace.

Tabel berikut menampilkan jenis peristiwa yang didukung, deskripsi, dan resource Meet yang diubah yang direpresentasikan dalam data peristiwa:

Jenis peristiwa Deskripsi Referensi Meet

google.workspace.meet.conference.v2.started

Konferensi dimulai di ruang rapat.

conferenceRecord

google.workspace.meet.conference.v2.ended

Konferensi berakhir di ruang rapat.

conferenceRecord

google.workspace.meet.participant.v2.joined

Peserta bergabung ke konferensi aktif di ruang rapat.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Peserta keluar dari konferensi aktif di ruang rapat.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

File rekaman dibuat untuk konferensi di ruang rapat.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

File transkrip dibuat untuk konferensi di ruang rapat.

conferenceRecord.transcript

Data peristiwa

Bagian ini menjelaskan data peristiwa dan contoh payload untuk peristiwa di ruang rapat Meet.

Saat langganan Google Workspace Anda menerima peristiwa dari Meet, kolom data berisi payload untuk peristiwa tersebut. Payload ini memiliki informasi tentang resource Google Workspace yang berubah. Misalnya, jika Anda telah berlangganan peristiwa tentang transkrip baru di ruang, payload untuk peristiwa ini berisi informasi tentang resource transcript yang berubah.

Data resource dalam payload peristiwa

Tabel berikut memberikan contoh payload JSON untuk langganan ke ruang rapat Meet. Contoh menggunakan konferensi conferenceRecords/AAA-BBB-CCC-DDD-EEE yang berlangsung di ruang. Untuk setiap peristiwa yang diterima langganan, payload akan muncul di kolom data dari peristiwa:

Contoh Jenis peristiwa Payload JSON

Konferensi dimulai untuk ruang rapat Meet.

google.workspace.meet.conference.v2.started

Mengecualikan data resource
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
Seorang peserta bergabung ke konferensi di ruang rapat Meet.

google.workspace.meet.participant.v2.joined

Mengecualikan data resource
{
    "participantSession":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
    }
}
Rekaman dibuat untuk konferensi di ruang rapat Meet. google.workspace.meet.recording.v2.fileGenerated
Mengecualikan data resource
{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
Transkrip dibuat untuk konferensi di ruang rapat Meet. google.workspace.meet.transcript.v2.fileGenerated
Mengecualikan data resource
{
    "transcript":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}