Berlangganan acara Google Meet

Halaman ini menjelaskan acara Google Meet yang dapat diikuti aplikasi Anda menggunakan Google Workspace Events API. Setelah Anda memutuskan yang Anda perlukan, buat langganan untuk mulai menerima acara dari Google Meet.

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

Acara Meet yang didukung

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

  • J konferensi dimulai atau berakhir di ruang rapat.
  • J peserta bergabung atau meninggalkan konferensi.
  • J rekaman akan dibuat untuk konferensi.
  • J transkrip akan dibuat untuk konferensi.

Resource yang dapat Anda pantau untuk mengetahui peristiwa

Untuk menerima acara, tentukan 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 pertemuan //meet.googleapis.com/spaces/SPACE

dengan SPACE adalah ID di nama resource resource space Meet REST API. Untuk mengetahui detailnya, lihat Bagaimana 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 Bekerja sama dengan peserta.

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

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

Jenis peristiwa untuk membuat langganan

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

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

Jenis peristiwa Deskripsi Referensi Meet

google.workspace.meet.conference.v2.started

Konferensi dimulai di ruang rapat.

conferenceRecord

google.workspace.meet.conference.v2.ended

Konferensi akan 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 meninggalkan konferensi aktif di ruang rapat.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

File rekaman akan 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 Perkenalkan, data berisi payload peristiwa. Payload ini memiliki informasi tentang Referensi Google Workspace yang berubah. Misalnya, jika Anda telah berlangganan tentang transkrip baru di ruang, {i>payload<i} untuk peristiwa ini berisi informasi tentang transcript resource yang berubah.

Data resource dalam payload peristiwa

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

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 akan 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"
    }
}