本指南介绍了如何使用 Google Meet REST API 创建和管理 Google Meet 会议。
会议空间表示举行会议的虚拟场所或持久性对象（例如会议室）。在任何时间，一个会议室中只能有一场正在进行的会议。会议空间还可帮助用户开会和查找共享资源。
如需使用会议空间，请参阅创建和管理会议空间。如需了解如何以编程方式配置会议空间，请参阅配置会议空间和成员。
如何调用会议空间方法
下表详细介绍了使用会议室方法所需的会议角色：
| 方法 | 所有者 | 参与者 | 其他 |
|---|---|---|---|
endActiveConference |
x | ||
get |
x | x | x |
| 带有设置 | x | ||
| 包含有效会议 | x | x | |
patch |
x |
Meet 如何识别会议室
Google 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.create。 会议空间已创建，返回的spaces对象包含meetingUri字符串。然后，系统会将meetingUri分发给参与者。对新的会议室进行投票。调用
spaces.get方法以检查会议状态。除了轮询之外，您还可以订阅 Meet 活动以接收推送通知。
开始会议。当第一位参与者点击会议室中的
meetingUri时，会议开始。activeConference对象已填充，并且已设置activeConference.conferenceRecord字符串。（可选）获取会议数据。在有效会议期间，您可以访问一些
conferenceRecord值。例如，调用conferenceRecords.participants.list方法可查看会议中的所有参与者。您还可以在会议结束后最多 30 天内访问这些信息。（可选）结束会议。在会议期间，会议所有者可以调用
spaces.endActiveConference方法，以编程方式结束所有参与者的有效会议。会议结束。当最后一位参与者退出时，会议结束。
轮询会议后制品。会议已结束 (
STATE=ENDED)，但工件尚未生成。会议的startTime和endTime也会填充。您必须轮询工件端点，直到工件对象STATE读取FILE_GENERATED。您可以订阅 Meet 事件，以便接收推送通知，而无需进行轮询。
获取会议后工件。生成录制内容和转写内容后，您可以检索这些工件。例如，调用
conferenceRecords.recordings.get方法可按录制 ID 获取录制内容。准备就绪后，系统会填充工件对象的 URI，并将其作为资源对象的一部分返回。