订阅 Google Meet 活动

本页介绍了应用可以订阅的 Google Meet 事件 使用 Google Workspace Events API确定好 事件类型，请创建 订阅以开始接收 Google Meet 中安排的活动。

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

支持的 Meet 活动

订阅 Google Workspace 后，您可以接收 Meet 中的以下变化类型：

可监控事件的资源

如要接收活动，请指定要监控的 Meet 资源 （称为订阅的目标资源）。

Google Workspace Events API 支持以下目标资源 适用于 Meet：

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

其中 SPACE 是 资源名称。space 有关详情，请参阅 如何 Meet 可识别会议空间。
用户 //cloudidentity.googleapis.com/users/USER

其中 USER 是 signedinUser.user Meet REST API participant资源的字段。 有关详情，请参阅 与参与者协作。

订阅会收到关于会议空间的事件， user 是以下类型之一：

  • 会议空间的所有者。
  • 组织者 与会议空间关联的 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 订阅收到以下事件的事件： 认识一下， data 字段包含事件的负载。此载荷包含 发生更改的 Google Workspace 资源。例如，如果您订阅了 与聊天室中的新转写活动有关，则这些活动的载荷包含 有关 transcript 更改的资源

事件载荷中的资源数据

下表提供了 Meet 会议空间。这些示例使用 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"
    }
}