本指南介绍了如何使用 Google Meet REST API 的 spaces 资源创建、获取和更新会议空间，以及结束有效会议。
创建会议空间
如需创建会议空间，请对 spaces 资源使用 create 方法。
该方法会返回 spaces 资源的实例，其中包括会议空间的配置 SpaceConfig 对象。它还包含 ActiveConference 对象，该对象是指向会议空间内当前 conferenceRecords 资源的链接。
以下代码示例展示了如何创建会议空间：
Java
Node.js
Python
Apps 脚本
function createMeetingSpace() {
const response = UrlFetchApp.fetch(
'https://meet.googleapis.com/v2/spaces',
{
method: 'post',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
},
payload: JSON.stringify({}),
}
);
const space = JSON.parse(response.getContentText());
Logger.log('Space name: ' + space.name);
Logger.log('Meeting URI: ' + space.meetingUri);
return space;
}
cURL
curl -X POST "https://meet.googleapis.com/v2/spaces" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
将 ACCESS_TOKEN 替换为授予 API 访问权限的访问令牌。
获取会议空间
如需获取有关有效会议空间及其设置的详细信息，请对 spaces 资源使用 get 方法。使用 spaces/{space} 或 spaces/{meetingCode} 格式设置 name 路径参数。如需了解详情，请参阅 Meet 如何识别会议室。
该方法会以 spaces 资源实例的形式返回会议空间。如需确定是否存在有效会议，请检查 activeConference 字段。
以下代码示例展示了如何检索会议空间：
Java
Node.js
Python
Apps 脚本
function getMeetingSpace(spaceName) {
// spaceName format: "spaces/{space}" or "spaces/{meetingCode}"
const response = UrlFetchApp.fetch(
`https://meet.googleapis.com/v2/${spaceName}`,
{
method: 'get',
headers: {
Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
},
}
);
const space = JSON.parse(response.getContentText());
Logger.log('Space name: ' + space.name);
Logger.log('Meeting URI: ' + space.meetingUri);
if (space.activeConference) {
Logger.log('Active conference: ' +
space.activeConference.conferenceRecord);
}
return space;
}
cURL
curl -X GET "https://meet.googleapis.com/v2/spaces/SPACE_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
将 ACCESS_TOKEN 替换为授予 API 访问权限的访问令牌。
将会议室名称值替换为会议室的唯一服务器生成的 ID。
更新会议室
如需更新会议空间的详细信息，请对 spaces 资源使用 patch 方法。使用 spaces/{space} 格式设置 space.name 路径参数。如需了解详情，请参阅 Meet 如何识别会议室。
patch 方法还接受可选的 updateMask 查询参数。该字段的类型为 FieldMask。这是一个英文逗号分隔的列表，其中包含您要在空间中更新的字段。
该方法会以 spaces 资源实例的形式返回会议空间。
以下代码示例展示了如何更新会议空间：
Java
Node.js
Python
Apps 脚本
function updateMeetingSpace(spaceName) {
// spaceName format: "spaces/{space}"
const baseUrl = 'https://meet.googleapis.com/v2/';
const mask = 'updateMask=config.accessType';
const url = `${baseUrl}${spaceName}?${mask}`;
const response = UrlFetchApp.fetch(url, {
method: 'patch',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
},
payload: JSON.stringify({
config: {
accessType: 'RESTRICTED',
},
}),
});
const space = JSON.parse(response.getContentText());
Logger.log('Updated space: ' + space.name);
return space;
}
cURL
curl -X PATCH "https://meet.googleapis.com/v2/spaces/SPACE_NAME?updateMask=config.accessType" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"config": {
"accessType": "RESTRICTED"
}
}'
将 ACCESS_TOKEN 替换为授予 API 访问权限的访问令牌。
将会议室名称值替换为会议室的唯一服务器生成的 ID。
结束正在进行的会议
如需结束会议空间（如果有）中的有效会议，请对 spaces 资源使用 endActiveConference 方法。
使用 spaces/{space} 格式设置 name 路径参数。请求和响应正文均为空。如需了解详情，请参阅 Meet 如何识别会议室。
以下代码示例展示了如何结束有效会议：
Java
Node.js
Python
Apps 脚本
function endActiveConference(spaceName) {
// spaceName format: "spaces/{space}"
const url =
`https://meet.googleapis.com/v2/${spaceName}:endActiveConference`;
UrlFetchApp.fetch(url, {
method: 'post',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
},
payload: JSON.stringify({}),
});
Logger.log(`Ended active conference in ${spaceName}`);
}
cURL
curl -X POST "https://meet.googleapis.com/v2/spaces/SPACE_NAME:endActiveConference" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
将 ACCESS_TOKEN 替换为授予 API 访问权限的访问令牌。
将会议室名称值替换为会议室的唯一服务器生成的 ID。