在 Google Meet 中回复活动

本文档介绍了如何通过 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 的活动数据

如需接收活动数据,您的应用可以执行以下任一操作:

下表说明了订阅事件与查询事件之间的区别以及订阅事件的原因:

订阅事件 查询数据
使用场景
  • 实时处理或响应事件。
  • 监控资源变化,以提升应用性能。
  • 手动检索数据。
  • 从 Meet 中提取所有数据(因服务中断或订阅处于非有效状态)。
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 资源(SpaceConferenceRecord
事件数据 包含或不包含资源数据的 Base64 编码字符串。如需查看载荷示例,请参阅事件数据 包含资源数据的 JSON 载荷。如需查看有效负载示例,请参阅参考文档中的 ConferenceRecord 资源。

限制

  • 日历邀请对象和受邀参加会议的其他参与者只能接收以下事件:google.workspace.meet.conference.v2.startedgoogle.workspace.meet.transcript.v2.fileGenerated