Google Meet REST API 概览

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

借助 Meet REST API,您可以执行以下操作:

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

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

使用场景

应用可以与 Meet REST API 集成,以执行以下任务:

  • 会议开始前:根据需要创建会议空间,量身打造会议体验。您还可以管理受邀者并预先配置设置。

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

  • 会议结束后:获取会议内容,例如录制内容和转写内容。

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

  • 销售和客户管理

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

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

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

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

常用术语

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

工件
Meet 针对会议生成的文件,例如 recordingstranscripts。 通常,会议结束后不久,制品即可供提取。
日历活动
Google 日历中包含多位参加者的活动,通常由会议组织者创建,其中包含会议的加入信息。 Meet 可能是活动的会议解决方案。
Call
使用 Meet 的会话,或通知他人通话即将开始或正在进行,并允许他们立即加入。
会议
会议是会议空间中的通话实例。用户通常会将此场景视为一次会议。
共同主持人
通话中的人员,由主持人授予主持人管理权限,但无法移除原来的主持人。
主机
创建通话(即会议组织者)的人员或控制通话的人员。请注意,会议组织者可以组织会议,但不必在会议举行时到场。主持人还可以将主持人权限委托给共同主持人
会议代码

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

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

会议名称

用于标识会议空间的服务器生成的唯一 ID。区分大小写。例如 jQCFfuBOdN5z。会议 ID 会在 spaces 资源的 name 字段中返回。

会议组织者

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

会议空间

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

会议 URI

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

参与者

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

参与者会话

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