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:
-
Subscribe to events using the Google Workspace Events API to receive events as they occur. For more information, see Subscribe to Google Meet events .
-
Query for recent data by calling the Meet REST API .
The following table explains the difference and reasons for subscribing to events versus querying for them:
- 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).
For a list of supported event types, see Event types for creating subscriptions in the Google Workspace Events API documentation.
For a list of supported endpoints, see the
Space
resource and the ConferenceRecord
resource in the Meet REST API documentation.Space
and ConferenceRecord
)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.startedandgoogle.workspace.meet.transcript.v2.fileGenerated.
