Respond to events from Google Meet

This document explains how to receive and respond to Google Meet events from Google Cloud Pub/Sub.

A Meet event represents an activity or change to a Meet resource, such as creating a new meeting. You can use events to understand what happened and then take action, or to respond in a meaningful way for your users.

Here are some examples of how you can use events:

  • Observe and respond to changes in a meeting, such as when a meeting starts or ends.

  • Track who attended the meeting for regulatory or training purposes.

  • Listen for the meeting transcript so the file contents can be parsed and logged into a CRM or database.

How events work

Whenever something happens in Google Meet, a Google Meet REST API resource is created or updated. Meet uses events to deliver information to your app about the type of activity that occurred, and the Meet REST API resource that was affected.

Meet categorizes events by type. Event types help you filter and receive only the type of information you need, and let you handle similar activities in the same way.

The following example shows how an activity in Meet affects a related Meet REST API resource, and the type of event that your Meet app receives:

Activity Meet REST API resource Event type
A user joins a meeting space. A ConferenceRecord resource is created. New conference record

Receive event data from Google Meet

To receive event data, your app can do either of the following:

The following table explains the difference and reasons for subscribing to events versus querying for them:

Subscribe to events Query for data
Use cases
  • Process or respond to events in real time.
  • Monitor changes in resources to improve the performance of your app.
  • Retrieve data manually.
  • Fetch all data from Meet (due to an outage or inactive subscription).
API Google Workspace Events API Meet REST API
Source of events Conference record and users Space and conference record
Supported events Conference record

For a list of supported event types, see Event types for creating subscriptions in the Google Workspace Events API documentation. 		Space and conference record

For a list of supported endpoints, see the Space resource and the ConferenceRecord resource in the Meet REST API documentation.
Event format A Google Cloud Pub/Sub message, formatted according to the CloudEvent specification. For details, see Structure of Google Workspace events. A Meet REST API resource (Space and ConferenceRecord)
Event data Base64-encoded string with or without resource data. For example payloads, see Event data. JSON payload that contains resource data. For an example payload, see the ConferenceRecord resource in the reference documentation.

Limitations
  • Calendar invitees and other participants invited to a conference can only receive the following events: google.workspace.meet.conference.v2.started and google.workspace.meet.transcript.v2.fileGenerated.