订阅 Google Meet 活动

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

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

支持的 Meet 目标资源

为了接收 Meet 事件，Google Workspace Events API 支持订阅以下资源：

  • 会议空间，表示为 space 资源。
  • 用户，表示为 Cloud Identity API user 资源。

支持的 Meet 活动

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

创建对 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"
    }
}