会议空间代表虚拟地点或举行会议的持久对象(例如会议室)。在任何情况下,一个场地都只能举行一场正在进行的会议。会议空间还有助于用户开会和查找共享资源。
以下部分详细介绍了如何创建、获取和更新会议空间。
Meet 如何识别会议空间
Google Meet REST API 会为每个会议空间生成一个 spaces
资源。name
字段是资源的资源名称。
以下是使用 name
字段标识会议空间的两种重要方法:
space
是空间的资源标识符,格式为spaces/{space}
。它是服务器生成的唯一 ID,区分大小写。 例如spaces/jQCFfuBOdN5z
。meetingCode
是聊天室的别名,格式为spaces/{meetingCode}
。它是可输入的唯一字符串,不区分大小写。例如abc-mnop-xyz
。长度上限为 128 个字符。它构成了meetingUri
的一部分:https://meet.google.com/abc-mnop-xyz
。
如需管理会议空间,请在 {name}
字段中使用以下值:
如需获取会议空间的详细信息,您可以使用
spaces/{space}
或别名spaces/{meetingCode}
。如需了解详情,请参阅获取会议空间。如要更新会议空间的详细信息,您只能使用
spaces/{space}
。 有关详情,请参阅更新会议空间。如需在会议空间中结束正在进行的会议,您只能使用
spaces/{space}
。如需了解详情,请参阅结束正在进行的会议。
创建会议空间
如需创建会议空间,请对 spaces
资源使用 create
方法。
该方法会返回 spaces
资源的实例,其中包含作为会议空间配置的 SpaceConfig
对象。它还包含 ActiveConference
对象,该对象是指向会议空间中当前 conferenceRecords
资源的链接。
以下代码示例展示了如何创建会议空间:
Java
Node.js
Python
获取会议空间
如需获取会议空间的详细信息,请对具有指定 name
的 spaces
资源使用 get
方法。如需了解详情,请参阅 Meet 如何识别会议空间。
该方法会返回会议空间作为 space
资源实例。
以下代码示例展示了如何检索会议空间:
Java
Node.js
Python
将聊天室名称替换为服务器为会议空间生成的唯一 ID。
更新会议聊天室
如需更新会议空间的详细信息,请对具有指定 name
的 spaces
资源使用 patch
方法。如需了解详情,请参阅 Meet 如何识别会议空间。
patch
方法还接受可选的 updateMask
参数。该字段的类型为 FieldMask
。这是您想在聊天室中更新的字段列表(以英文逗号分隔)。
该方法会返回会议空间作为 spaces
资源实例。
以下代码示例展示了如何更新会议空间:
Java
Node.js
Python
将聊天室名称替换为服务器为会议空间生成的唯一 ID。
结束正在进行的会议
如需在会议空间中结束正在进行的会议,请对 spaces
资源使用 spaces.endActiveConference
方法。请求和响应正文均为空。如需了解详情,请参阅 Meet 如何识别会议空间。
以下代码示例展示了如何结束正在进行的会议:
Java
Node.js
Python
将聊天室名称替换为服务器为会议空间生成的唯一 ID。