В этом руководстве объясняется, как создать, получить и обновить пространство для совещаний, а также завершить активную конференцию с помощью ресурса spaces в REST API Google Meet.
Создайте место для встреч.
Для создания переговорной комнаты используйте метод create ресурса spaces .
Метод возвращает экземпляр ресурса spaces , который включает объект SpaceConfig , представляющий собой конфигурацию для переговорного пространства. Он также содержит объект ActiveConference , являющийся ссылкой на текущий ресурс conferenceRecords в переговорном пространстве.
В следующем примере кода показано, как создать пространство для встреч:
Java
Node.js
Python
Apps Script
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.
Найдите место для проведения встречи
Чтобы получить подробную информацию об активном конференц-зале и его настройках, используйте метод get ресурса ` spaces . Задайте параметр пути name в формате spaces/{space} или spaces/{meetingCode} . Дополнительную информацию см. в разделе «Как Meet идентифицирует конференц-зал» .
Метод возвращает пространство для совещаний в виде экземпляра ресурса spaces . Чтобы определить, существует ли активная конференция, проверьте поле activeConference .
Следующий пример кода демонстрирует, как получить информацию о месте проведения встречи:
Java
Node.js
Python
Apps Script
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.
Замените значение имени пространства уникальным идентификатором переговорной комнаты, сгенерированным сервером.
Обновите конференц-зал.
Чтобы обновить сведения о месте проведения совещания, используйте метод patch для ресурса spaces . Задайте параметр пути space.name в формате spaces/{space} . Дополнительную информацию см. в разделе «Как Meet идентифицирует место проведения совещания» .
Метод patch также принимает необязательный параметр запроса updateMask . Поле имеет тип FieldMask . Это список полей, разделенных запятыми, которые вы хотите обновить в пространстве.
Метод возвращает объект переговорной комнаты в виде экземпляра ресурса spaces .
В следующем примере кода показано, как обновить информацию о месте проведения совещания:
Java
Node.js
Python
Apps Script
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.
Замените значение имени пространства уникальным идентификатором переговорной комнаты, сгенерированным сервером.
Завершение активной конференции
Чтобы завершить активную конференцию в рамках переговорного пространства (если таковое имеется), используйте метод endActiveConference ресурса spaces . Укажите параметр пути name в формате spaces/{space} . Тело запроса и ответа должны быть пустыми. Дополнительную информацию см. в разделе «Как Meet идентифицирует переговорное пространство» .
Следующий пример кода демонстрирует, как завершить активную конференцию:
Java
Node.js
Python
Apps Script
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.
Замените значение имени пространства уникальным идентификатором переговорной комнаты, сгенерированным сервером.
Связанные темы
- Обзор площадок для проведения встреч в Google Meet
- Настройка параметров переговорной комнаты
- Управление участниками переговорной комнаты
- Работа с конференциями