本文档介绍了如何通过 Google Cloud Pub/Sub 接收和响应 Google Meet 事件。
Meet 事件表示 Meet 资源的活动或更改,例如创建新会议。您可以使用事件来了解发生了什么情况,然后采取行动或以有意义的方式回应用户。
以下是一些有关如何使用事件的示例:
观察并响应会议中的变化,例如会议开始或结束。
出于监管或培训目的,跟踪会议的参会者。
监听会议转写内容,以便解析文件内容并将其记录到 CRM 或数据库中。
事件的运作方式
每当 Google Meet 中发生某些事件时,系统都会创建或更新 Google Meet REST API 资源。Meet 会使用事件向您的应用传递有关发生的活动类型和受影响的 Meet REST API 资源的信息。
Meet 会按类型对活动进行分类。事件类型可帮助您过滤并仅接收所需类型的信息,并让您以相同的方式处理类似活动。
以下示例展示了 Meet 中的活动如何影响相关的 Meet REST API 资源,以及您的 Meet 应用会收到哪种类型的事件:
| 活动 | Meet REST API 资源 | 事件类型 |
|---|---|---|
| 用户加入会议室。 | 创建 ConferenceRecord 资源。 |
新的分区战绩 |
接收来自 Google Meet 的活动数据
如需接收活动数据,您的应用可以执行以下任一操作:
使用 Google Workspace Events API 订阅事件,以便在事件发生时接收通知。如需了解详情,请参阅订阅 Google Meet 事件。
通过调用 Meet REST API 查询近期数据。
下表说明了订阅事件与查询事件之间的区别以及订阅事件的原因:
| 订阅事件 | 查询数据 | |
|---|---|---|
| 使用场景 |
|
|
| API | Google Workspace Events API | Meet REST API |
| 事件来源 | 联合会战绩和用户 | 聊天室和会议记录 |
| 支持的事件 |
会议记录
如需查看支持的事件类型的列表,请参阅 Google Workspace Events API 文档中的 创建订阅的事件类型。 |
会议室和会议记录
如需查看受支持的端点列表,请参阅 Meet REST API 文档中的 Space 资源和 ConferenceRecord 资源。
|
| 事件格式 | 根据 CloudEvent 规范设置格式的 Google Cloud Pub/Sub 消息。如需了解详情,请参阅 Google Workspace 事件的结构。 |
Meet REST API 资源(Space 和 ConferenceRecord)
|
| 事件数据 | 包含或不包含资源数据的 Base64 编码字符串。如需查看载荷示例,请参阅事件数据。 |
包含资源数据的 JSON 载荷。如需查看有效负载示例,请参阅参考文档中的 ConferenceRecord
资源。
|
限制
- 日历邀请对象和受邀参加会议的其他参与者只能接收以下事件:
google.workspace.meet.conference.v2.started和google.workspace.meet.transcript.v2.fileGenerated。