Google Meet 会议空间概览

使用 spaces.create 方法创建 Google Meet 聊天室

本指南介绍了如何使用 Google Meet REST API 创建和管理 Google Meet 会议。

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

如需了解如何使用会议空间，请参阅管理会议空间。如需了解如何以编程方式配置会议空间，请参阅配置会议空间设置。如需管理会议室成员，请参阅管理会议室成员。

会议空间方法权限

下表详细比较了使用会议室方法所需的会议角色：

方法 所有者 参与者 其他
endActiveConference
get
     通过设置
     with active conference
patch

Meet 如何识别会议室

Meet REST API 会为每个会议空间生成一个 spaces 资源。spaces 资源提供了多个加入会议的入口点。

下表显示了如何识别和加入会议空间：

字段名称 说明
name 聊天室的名称。{space} 字符串是聊天室的资源标识符，格式为 spaces/{space}。 这是由服务器生成的唯一 ID，区分大小写。例如：spaces/jQCFfuBOdN5z。
meetingCode 聊天室名称的别名。{meetingCode} 是可输入且唯一的字符串，不区分大小写。其格式为 spaces/{meetingCode}。例如 spaces/abc-mnop-xyz。长度上限为 128 个字符。 它属于 meetingUri 的一部分： https://meet.google.com/abc-mnop-xyz。
phoneAccess 相应会议空间的电话接入方式。 phoneAccess 对象包含拨入会议所需的各种信息，包括会议室的区域电话号码和特定于该电话号码的 PIN 码。PIN 码仅包含十进制数字，长度可能有所不同。例如："pin": 19707127300

与 Meet 界面类似，spaces 资源包含一组有限的拨入号码。您可以通过在以下网址 https://meet.google.com/tel/ 后面附加 {meetingCode} 来查看会议室的其他电话号码。例如，https://meet.google.com/tel/abc-mnop-xyz。
gatewaySipAccess 相应会议空间的会话发起协议 (SIP) 访问方法。SIP 地址详细说明了第三方视频会议硬件如何查找和加入 Meet 会议。gatewaySipAccess 对象包含 URI 和数字访问代码。Meet 支持 SIP URI 方案。

如需管理会议空间，请为 name 字段使用以下值：

  • 如需获取会议室的相关详情，您可以使用 spaces/{space} 或别名 spaces/{meetingCode}。如需了解详情，请参阅获取会议室。

  • 如需更新会议室的详细信息，您只能使用 spaces/{space}。如需了解详情，请参阅更新会议室。

  • 如需结束会议空间内正在进行的会议，您只能使用 spaces/{space}。如需了解详情，请参阅结束正在进行的会议。

  • 如需管理会议室的成员，您只能使用 spaces/{space}。不支持别名 {meetingCode}。如需了解详情，请参阅管理会议室成员。

OAuth 范围（按使用情形）

使用 Meet 进行身份验证指南列出了所有 Meet REST API 范围及其验证敏感度层级。不过，在处理会议室时，范围要求会有所不同，具体取决于会议室是由您的应用还是外部应用（例如 Google 日历）创建的。

下表列出了根据特定会议空间使用情形所需的 OAuth 范围：

使用场景 范围代码
为其他应用创建的空间设置自动制品生成。 https://www.googleapis.com/auth/meetings.space.settings
获取或列出由其他应用创建的会议中的制品。 https://www.googleapis.com/auth/meetings.space.readonly
获取或列出由第三方应用创建的会议室的其他会前设置。 https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
读取和修改用户可通过任何其他应用（例如日历）访问的所有会议空间的设置。 https://www.googleapis.com/auth/meetings.space.settings

如需查看所有受支持的范围及其授权敏感度层的完整列表，请参阅 Meet REST API 范围。

会议空间的生命周期

会议空间在其生命周期中会经历多种状态。下图显示了会议室生命周期的高级步骤：

会议空间生命周期。
图 1. 会议空间的生命周期。

  1. 调用 spaces.create。 会议空间已创建，返回的 spaces 对象包含 meetingUri 字符串。然后，系统会将 meetingUri 分发给参与者。 在会议开始前，您可以配置会议空间设置和管理会议空间成员。

  2. 对新会议室进行投票。调用 spaces.get 方法以检查会议状态。

    除了轮询之外，您还可以订阅 Meet 活动以接收推送通知。

  3. 开始会议。当第一位参与者点击会议室中的 meetingUri 时，会议开始。activeConference 对象已填充，并且已设置 activeConference.conferenceRecord 字符串。

  4. （可选）获取会议数据。在有效会议期间，您可以访问一些 conferenceRecord 值。例如，调用 conferenceRecords.participants.list 方法可查看会议中的所有参与者。您还可以在会议结束后最多 30 天内访问这些信息。

  5. （可选）结束会议。在会议期间，会议所有者可以调用 spaces.endActiveConference 方法，以编程方式结束所有参与者的有效会议。

  6. 会议结束。当最后一位参与者退出时，会议结束。

  7. 轮询会议后制品。会议已结束 (STATE=ENDED)，但工件尚未生成。会议的 startTime 和 endTime 也会填充。您必须轮询工件端点，直到工件对象 STATE 读取 FILE_GENERATED。

    您可以订阅 Meet 事件，以便接收推送通知，而无需轮询。

  8. 获取会议后工件。生成数据制品（例如录制内容、转写内容和智能会议记录）后，您可以检索这些数据制品。例如，调用 conferenceRecords.recordings.get 方法可按录制 ID 获取录制内容。

    准备就绪后，系统会填充制品对象的 URI，并将其作为资源对象的一部分返回。