Berlangganan acara Google Meet

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

Selain berlangganan ke peristiwa, Anda juga dapat membuat kueri untuk peristiwa dengan memanggil Google Meet REST API. Panggil Meet REST API untuk mengambil peristiwa secara berkala, atau mengejar peristiwa yang mungkin terlewat dari langganan karena pemadaman layanan. Untuk mempelajari cara menerima dan merespons peristiwa Meet, lihat Merespons peristiwa dari Google Meet dalam dokumentasi Meet.

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

Peristiwa Meet yang didukung

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

  • Konferensi dimulai atau diakhiri di ruang rapat.
  • Peserta bergabung atau keluar dari konferensi.
  • Perekaman dimulai, diakhiri, atau file dibuat untuk konferensi.
  • Catatan cerdas dimulai, diakhiri, atau file dibuat untuk konferensi.
  • Transkrip dimulai, berakhir, atau file dibuat untuk konferensi.

Resource yang dapat Anda pantau untuk peristiwa

Untuk menerima peristiwa, tentukan fasilitas Meet yang akan dipantau, yang disebut fasilitas 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 sebagai ID dalam nama resource dari resource spaces 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 resource participants Meet REST API. Untuk mengetahui detailnya, lihat Bekerja dengan peserta.

Langganan menerima peristiwa tentang semua ruang rapat tempat pengguna adalah pemilik ruang rapat. Biasanya, pemilik ruang rapat juga merupakan penyelenggara acara Google Kalender yang terkait dengan ruang rapat.

Jenis peristiwa untuk membuat langganan

Saat Anda membuat langganan ke resource Meet, gunakan 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, tentukan 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 untuk langganan ke resource Meet:

Event type Format Data resource
Konferensi dimulai di ruang rapat. google.workspace.meet.conference.v2.started conferenceRecord
Konferensi berakhir di ruang rapat. google.workspace.meet.conference.v2.ended conferenceRecord
Peserta bergabung ke konferensi aktif di ruang rapat. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Peserta keluar dari konferensi aktif di ruang rapat. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Perekaman dimulai untuk konferensi di ruang rapat. google.workspace.meet.recording.v2.started conferenceRecord.recording
Perekaman berakhir untuk konferensi di ruang rapat. google.workspace.meet.recording.v2.ended conferenceRecord.recording
File rekaman dibuat untuk konferensi di ruang rapat. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Catatan cerdas dimulai untuk konferensi di ruang rapat. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Catatan cerdas berakhir untuk konferensi di ruang rapat. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
File catatan cerdas dibuat untuk konferensi di ruang rapat. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
Transkrip dimulai untuk konferensi di ruang rapat. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Transkrip berakhir untuk konferensi di ruang rapat. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
File transkrip dibuat untuk konferensi di ruang rapat. google.workspace.meet.transcript.v2.fileGenerated 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 akan 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 transcripts yang berubah.

Data resource dalam payload peristiwa

Tabel berikut memberikan contoh payload JSON untuk langganan ke ruang rapat Meet. Contoh ini menggunakan ID rekaman konferensi (misalnya, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) untuk mengidentifikasi ruang rapat. Untuk mengetahui informasi selengkapnya, lihat Cara Meet mengidentifikasi ruang rapat.

Untuk setiap peristiwa yang diterima langganan, payload akan muncul di kolom data peristiwa:

Jenis peristiwa Payload JSON

Konferensi dimulai atau berakhir untuk ruang rapat Meet.

  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Tidak termasuk data resource:

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}

Peserta bergabung atau keluar dari konferensi di ruang rapat Meet.

  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Tidak termasuk data resource:

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}

Rekaman dimulai, berakhir, atau file dibuat untuk konferensi di ruang rapat Meet.

  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

Tidak termasuk data resource:

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}

Catatan cerdas dimulai, diakhiri, atau file dibuat untuk konferensi di ruang rapat Meet.

  • google.workspace.meet.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

Tidak termasuk data resource:

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}

Transkrip dimulai, berakhir, atau file dibuat untuk konferensi di ruang rapat Meet.

  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • google.workspace.meet.transcript.v2.fileGenerated

Tidak termasuk data resource:

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}

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.