订阅 Google Meet 活动

本页介绍了您的应用可以使用 Google Workspace Events API 订阅的 Google Meet 事件。确定所需的事件类型后，创建订阅即可开始接收 Meet 中的事件。

如需详细了解如何为 Meet 开发应用，请参阅 Google Meet REST API 概览。

支持的 Meet 事件

通过 Google Workspace 订阅，您可以接收与 Meet 中的以下类型更改相关的事件：

您可以监控哪些资源以便发现事件

如需接收事件，您需要指定要监控的 Meet 资源，该资源称为订阅的目标资源。

Google Workspace Events API 支持 Meet 的以下目标资源：

目标资源 格式 限制（如果适用）
会议空间 //meet.googleapis.com/spaces/SPACE

其中，SPACE 是 Meet REST API space 资源的 资源名称中的 ID。 如需了解详情，请参阅Meet 如何识别会议空间。
用户 //cloudidentity.googleapis.com/users/USER

其中 USER 是 Meet REST API participant 资源的 signedinUser.user 字段中的 ID。 如需了解详情，请参阅与参与者互动。

该订阅会接收与用户具有以下任一身份的会议室相关的事件：

  • 会议室的所有者。
  • 会议聊天室中的参与者。
  • 与会议室关联的 Google 日历活动的组织者。

用于创建订阅的事件类型

创建 Meet 资源订阅时，您可以使用 eventTypes[] 字段指定要接收的事件类型。事件类型的格式遵循 CloudEvents 规范，例如 google.workspace.APPLICATION.RESOURCE.VERSION.ACTION。例如，若要接收有关 Meet 聊天室会议中新参与者的事件，您可以将事件类型指定为 google.workspace.meet.participant.v2.joined。如需详细了解事件的运作方式，请参阅 Google Workspace 事件的结构。

下表显示了支持的事件类型、说明以及事件数据中表示的更改 Meet 资源：

Event type 说明 Meet 资源

google.workspace.meet.conference.v2.started

会议在会议室中开始。

conferenceRecord

google.workspace.meet.conference.v2.ended

会议在会议室中结束。

conferenceRecord

google.workspace.meet.participant.v2.joined

参与者加入会议室中正在进行的会议。

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

参与者离开会议聊天室中正在进行的会议。

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

系统会为会议空间中的会议生成录制文件。

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

系统会为会议室中的会议生成转写文件。

conferenceRecord.transcript

事件数据

本部分介绍了 Meet 会议室中事件的数据和示例载荷。

当您的 Google Workspace 订阅收到 Meet 发送的事件时，data 字段将包含该事件的载荷。此载荷包含有关发生更改的 Google Workspace 资源的信息。例如，如果您订阅了聊天室中新转写内容的事件，则这些事件的载荷包含有关所更改 transcript 资源的信息。

事件载荷中的资源数据

下表提供了 Meet 会议室订阅的 JSON 载荷示例。示例使用在聊天室中举行的会议 conferenceRecords/AAA-BBB-CCC-DDD-EEE。对于订阅收到的每个事件，载荷都会显示在事件的 data 字段中：

示例 Event type JSON 载荷

Meet 会议室开始召开会议。

google.workspace.meet.conference.v2.started

排除资源数据
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
参与者在 Meet 会议室中加入会议。

google.workspace.meet.participant.v2.joined

排除资源数据
{
    "participantSession":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
    }
}
系统会为 Meet 会议空间中的会议生成录制内容。 google.workspace.meet.recording.v2.fileGenerated
排除资源数据
{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
系统会为 Meet 会议空间中的会议生成转写内容。 google.workspace.meet.transcript.v2.fileGenerated
排除资源数据
{
    "transcript":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}