Berlangganan acara Google Meet

Halaman ini menjelaskan acara Google Meet yang dapat diikuti aplikasi Anda menggunakan Google Workspace Events API. Setelah 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 REST API Google Meet.

Resource target Meet yang didukung

Untuk menerima acara Meet, Google Workspace Events API mendukung langganan ke referensi berikut:

  • Ruang rapat, yang direpresentasikan sebagai fasilitas space.
  • Pengguna, direpresentasikan sebagai resource user Cloud Identity API.

Acara Meet yang didukung

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

  • Konferensi dimulai atau berakhir di ruang rapat.
  • Peserta bergabung atau keluar dari konferensi.
  • Rekaman dibuat untuk konferensi.
  • Transkrip dibuat untuk sebuah konferensi.

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

Tabel berikut menampilkan jenis peristiwa yang didukung, deskripsi, dan resource Meet yang diubah dan 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 akan dibuat untuk konferensi di ruang rapat.

conferenceRecord.transcript

Data peristiwa

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

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

Data resource dalam payload peristiwa

Tabel berikut menyediakan contoh payload JSON untuk langganan ke ruang rapat Meet. Contoh tersebut menggunakan conferenceRecords/AAA-BBB-CCC-DDD-EEE konferensi yang berlangsung di ruang. Untuk setiap peristiwa yang diterima langganan, payload akan muncul di kolom data 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"
    }
}
      
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 akan 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"
    }
}