Google Meet REST API 概览

借助 Google Meet REST API，您可以为 Google Meet 创建和管理会议，并直接从您的应用为用户提供入口点。

借助 Meet REST API，您可以执行以下操作：

  • 创建会议空间，以便用户通过视频进行交流。
  • 按资源名称获取会议空间或会议。
  • 获取参与者和参与者会话的列表。
  • 获取会议内容（录制内容、转写内容和转写条目）。

您还可以使用 Google Workspace Events API 订阅 Meet 事件。如需接收更改通知，您可以订阅指定的会议空间或属于指定用户的所有会议空间。 如需了解详情，请参阅：

使用场景

应用可以与 Meet REST API 集成，以执行以下任务：

  • 会议开始前：通过 创建会议空间，根据需要定制会议体验。您还可以管理受邀者和预配置设置。

  • 会议期间：检索会议信息，以根据返回的元数据更改应用 体验。

  • 会议结束后：提取会议内容，例如录制内容 和转写内容。

以下是一些您可能想要使用 Meet REST API 的示例：

  • 销售和客户管理

    • 检索会议和参与者信息以供记录。
    • 提取会议内容并将其发布到账号中。
    • 通过 AI 模型运行转写内容和录制内容，以生成培训和销售效果分析。

  • 学习与发展

    • 创建和预配置培训会议。
    • 为培训师和会话负责人分配共同主持人角色。
    • 检索录制内容，以便学生在课程结束后查看资料。

  • 开发者运营

    • 创建会议以立即联系团队成员。
    • 通过分享实时会议和参与者信息，让其他利益相关者加入正在进行的会议。
    • 通过 AI 模型运行转写数据，以生成正确的后续步骤。
在 Chat 聊天室中与同事创建并加入动态会议。
图 1.在 Chat 聊天室中与同事创建和加入动态会议。

您还可以将其他 Google Workspace API（例如 Chat API）整合到您的应用中，以进一步加强协作。如需了解详情，请参阅 Chat 使用场景。

常用术语

以下是此 API 中使用的常用术语列表：

内容
Meet 针对 会议 生成的文件，例如 recordings 和 transcripts。 内容会保存到 会议组织者 的 Google 云端硬盘中。会议结束后，通常很快就可以提取这些内容。
日历活动
Google 日历中的一项活动，其中包含多位参加者，通常由 会议组织者创建，其中包含会议加入信息。Meet 可能是该活动的 会议 解决方案。
通话
使用 Meet 的会话，或通知他人通话即将开始或正在进行，并允许他们立即加入。
会议
会议是 会议空间 内 通话 的一个实例。用户通常将此场景视为一次会议。
会议记录
每个 会议 实例的唯一 ID。它会在会议开始时自动创建。 conferenceRecords 资源使用 conferenceRecords/{conferenceRecord} 格式。例如，conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ。
共同主持人
_通话_ 中由 _主持人_授予主持人管理权限的人员，但无法移除原来的主持人。
拨号加入
使用电话参与 通话 或收听直播通话。
主持人
创建 通话 的人（即 会议组织者）或控制通话的人。请注意，会议组织者可以组织会议，但会议举行时可能不在场。主持人还可以将主持人权限委托给 共同主持人。
会议代码

一个可输入的 10 个字符的唯一字符串，用于 会议空间 的 会议 URI 中。它不区分大小写。例如，abc-mnop-xyz。长度上限为 128 个字符。

会议代码不应长期存储，因为它们可能会与会议空间分离，并且将来可能会重复用于不同的会议空间。一般来说，会议代码将在上次使用后 365 天过期。如需了解详情，请参阅了解 Google Meet 中的会议代码。

会议名称

服务器生成的唯一 ID，用于标识 会议空间。它区分大小写。例如，jQCFfuBOdN5z。会议 ID 会在 name 资源的 spaces 字段中返回。如需了解详情，请参阅 Meet 如何标识会议空间。

会议组织者

创建 会议空间 的用户。此用户也可以被视为会议所有者。他们可能不在 通话 期间在场，也可能不是会议 主持人。只能有一位会议组织者。

会议空间

举行 会议 的虚拟场所或持久对象（例如会议室）。任何时候，一个空间中只能举行一场正在进行的会议。会议空间还可以帮助用户会面和查找共享资源。

会议 URI

一个可点击的网址，用于发起 通话 或让用户加入通话。每次通话都有一个唯一的网址，该网址由 https://meet.google.com/ 后跟 会议代码 组成。例如，https://meet.google.com/abc-mnop-xyz。

参与者

加入 通话 的人，或使用 副屏 模式 观看的人，或连接到通话的会议室设备。每个人都有一个 participants 资源。当参与者加入 会议 时，系统会分配一个 唯一 ID。

参与者会话

为加入 通话 的每个参与者-设备对创建的唯一会话 ID。每个会话都有一个 participantSessions 资源。如果 参与者 使用同一参与者-设备对多次加入同一通话，则每次都会分配一个唯一的会话 ID。

SIP 地址

会话发起协议 (SIP) 地址详细说明了第三方视频会议硬件如何查找和加入 Meet 会议。Meet 支持 SIP URI scheme。