会议空间代表虚拟地点或举行会议的持久对象(例如会议室)。一个聊天室中任何时候只能有一场正在进行的会议。会议室还可帮助用户会面和查找共享资源。
以下部分详细介绍了如何创建、获取和更新会议室。
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。
更新会议空间
如需更新会议室的详细信息,请对 spaces
资源使用 patch
方法,并指定 name
。如需了解详情,请参阅 Meet 如何识别会议空间。
patch
方法还接受一个可选的 updateMask
参数。该字段的类型为 FieldMask
。这是您要更新的聊天室中字段的逗号分隔列表。
该方法会将会议室作为 spaces
资源的实例返回。
以下代码示例展示了如何更新会议室:
Java
Node.js
Python
将聊天室名称替换为会议聊天室由服务器生成的唯一 ID。
结束正在进行的会议
如需结束会议室中正在进行的会议,请对 spaces
资源使用 spaces.endActiveConference
方法。请求正文和响应正文均为空。如需了解详情,请参阅Meet 如何识别会议空间。
以下代码示例展示了如何结束正在进行的会议:
Java
Node.js
Python
将聊天室名称替换为会议聊天室由服务器生成的唯一 ID。