Google Meet REST API 概览

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

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

  • 创建和配置会议空间，以便用户通过视频进行连接。
  • 预配置会议室访问权限级别、内容审核设置以及自动录制或转写功能。
  • 管理会议聊天室成员并分配共同主持人角色。
  • 在会议空间内以编程方式结束有效会议。
  • 获取会议记录、出席情况详细信息和参与者会话元数据。
  • 检索会议数据制品（录制内容、转写内容和转写条目）。

您还可以使用 Google Workspace Events API 订阅 Meet 事件。如需接收有关变更的通知，您可以订阅指定会议室或指定用户的所有会议室。 有关详情，请参阅：

使用场景

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

  • 会议前：按需创建会议室、预先配置访问限制（开放、可信或受限）、应用主持人控制功能（屏幕共享、聊天、表情符号、麦克风和摄像头）、配置自动录制或自动转写，以及为会议室成员分配共同主持人角色。

  • 在会议期间：检索有效会议元数据和参与者会话、动态管理成员、使用 Google Workspace Events API 监听实时生命周期事件，或以编程方式结束有效会议。

  • 会议结束后：检索会议记录和出席情况日志，从 Google 云端硬盘下载录制内容和 Google 文档转写内容，并访问精细的转写内容语音条目，以便进行指导、合规性检查或 AI 分析。

您可能希望使用 Meet REST API 执行的一些操作包括：

  • 销售和账号管理

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

  • 学习与发展

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

  • 客户支持和咨询

    • 直接从帮助台工单或客户门户创建安全且受限的会议空间。
    • 预先配置主持人管理权限，以便只有支持人员可以演示或管理出席情况。
    • 启用自动录制或转写功能，以便进行质量保证和合规性记录。
    • 在预约或支持会话结束时以编程方式结束有效的会议。

  • 开发者运营

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

您还可以将其他 Google Workspace API（例如 Chat API）集成到应用中，以进一步提升协作效率。如需了解详情，请参阅聊天用例。

常用术语

以下是此 API 中使用的一些常用术语：

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

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

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

会议名称

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

会议组织者

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

会议空间

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

会议 URI

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

成员

明确添加到会议室并具有指定角色（例如 COHOST）的用户。与仅在实时会议期间在场的参与者不同，成员与持久性会议室相关联，并且在会议室中的多次会议中保留其权限。

参与者

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

参与者会话

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

录制

录制会议时生成的 MP4 视频文件和关联的元数据。录制的内容会保存到会议组织者的云端硬盘中，并可作为会议记录进行检索。

SIP 地址

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

转写文稿

以 Google 文档文件的形式 导出到会议组织者的云端硬盘，其中包含会议中的语音对话。

转写条目

会议中参与者的转写语音的离散片段。每条记录都包含参与者身份、时间戳、语音内容和语言代码，并且在会议结束后 30 天内可供查看。