在 Google Meet 中回复活动

本文档介绍了如何通过 Google Cloud Pub/Sub 接收和响应 Google Meet 事件。

Meet 事件表示 Meet 资源的活动或更改，例如创建新会议。您可以使用事件来了解发生了什么情况，然后采取行动或以有意义的方式回应用户。

以下是一些有关如何使用事件的示例：

  • 观察并响应会议中的变化，例如会议开始或结束。

  • 出于监管或培训目的，跟踪会议的参会者。

  • 监听会议转写内容，以便解析文件内容并将其记录到 CRM 或数据库中。

事件的运作方式

每当 Google Meet 中发生某些事件时，系统都会创建或更新 Google Meet REST API 资源。Meet 会使用事件向您的应用传递有关发生的活动类型和受影响的 Meet REST API 资源的信息。

新会议空间如何触发事件的示例。
图 1.用户创建会议空间，系统会创建 Space 资源。然后，Meet 会创建一个包含新会议空间相关数据的活动。

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 资源（Space 和 ConferenceRecord）
事件数据 包含或不包含资源数据的 Base64 编码字符串。如需查看载荷示例，请参阅事件数据。 包含资源数据的 JSON 载荷。如需查看有效负载示例，请参阅参考文档中的 ConferenceRecord 资源。

示例：检索有关会议室参与者的活动

在此示例中，Meet 应用希望接收有关会议空间中参与者变更的信息。在会议空间中，参与者加入正在进行的会议，这会填充 ParticipantSession 资源并触发新事件。然后，您可以使用 subscribe 或 query 方法获取有关这些事件的信息。

订阅事件

为了实时接收事件，Meet 应用会调用 Google Workspace Events API subscriptions.create 方法，以订阅会议空间中的所有类型的事件。创建订阅后，Meet 应用即可开始接收事件。

使用 Google Workspace Events API 订阅参与者事件的 Meet 应用。
图 2. Meet 应用通过使用 Google Workspace Events API 的订阅接收参与者事件。

在图 2 中，Meet 应用有效订阅了会议空间，因此每当会议空间中的参与者会话发生变化时，该应用都会收到一个事件。然后，Meet 应用可以实时响应任何活动，例如了解参与者何时加入或离开正在进行的会议。

如需了解如何使用 Google Workspace Events API 创建订阅，请参阅 Google Workspace Events API 文档。

查询近期活动

除了在事件发生时接收事件之外，Meet 应用还可以调用 Meet REST API 来列出与参与者活动相关的近期会议室事件。

使用 Meet REST API 查询参与者事件的 Meet 应用。
图 3. Meet 应用通过使用 Meet REST API 查询会议室活动来接收最近的参与者活动。

在图 3 中，Meet 应用在所有参与者会话活动发生后调用 Meet REST API conferenceRecords.participants.participantSessions.list 方法。Meet REST API 会返回一个 ParticipantSession 资源列表，其中包含每项变更。然后，Meet 应用可以根据最近的活动进行处理或做出响应，例如创建加入和离开会议的参与者名单。

如需使用 Meet REST API 查询活动，请参阅列出所有参与者会话。

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