Este guia explica como criar, receber e atualizar um espaço de reunião, além de encerrar uma
conferência ativa no recurso spaces da API REST do Google Meet.
Criar um espaço para reuniões
Para criar um espaço para reuniões,
use o método create
no recurso spaces.
O método retorna uma instância de um recurso spaces, que inclui o objeto SpaceConfig, que é a configuração do espaço para reuniões. Ele também contém o objeto
ActiveConference
que é um link para o recurso
conferenceRecords
atual no espaço de reunião.
O exemplo de código a seguir mostra como criar um espaço para reuniões:
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 '{}'
Substitua ACCESS_TOKEN pelo token de acesso que concede acesso à API.
Encontrar um espaço para reuniões
Para ver detalhes sobre um espaço para reuniões ativo e as configurações dele, use o método
get no recurso
spaces. Defina o parâmetro de caminho
name usando o formato spaces/{space} ou
spaces/{meetingCode}. Para mais informações, consulte Como o Meet identifica um espaço de reunião.
O método retorna um espaço para reuniões como uma instância do recurso
spaces. Para determinar se uma conferência ativa existe, examine o campo activeConference.
O exemplo de código a seguir mostra como recuperar um espaço para reuniões:
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"
Substitua ACCESS_TOKEN pelo token de acesso que concede acesso à API.
Substitua o valor do nome do espaço pelo ID exclusivo gerado pelo servidor para o espaço de reunião.
Atualizar um espaço para reuniões
Para atualizar os detalhes de um espaço para reuniões, use o método
patch no recurso
spaces. Defina o parâmetro de caminho
space.name usando o formato spaces/{space}. Para mais
informações, consulte Como o Meet identifica um espaço de
reunião.
O método patch também usa um parâmetro de consulta updateMask opcional. O campo é do tipo FieldMask.
É uma lista separada por vírgulas dos campos que você quer atualizar no espaço.
O método retorna um espaço para reuniões como uma instância do recurso
spaces.
O exemplo de código a seguir mostra como atualizar um espaço para reuniões:
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"
}
}'
Substitua ACCESS_TOKEN pelo token de acesso que concede acesso à API.
Substitua o valor do nome do espaço pelo ID exclusivo gerado pelo servidor para o espaço de reunião.
Encerrar uma conferência ativa
Para encerrar uma conferência ativa em um espaço para reuniões (se houver um), use o método
endActiveConference
no recurso spaces.
Defina o parâmetro de caminho name usando o formato spaces/{space}. O corpo da solicitação e da resposta estão vazios. Para mais informações, consulte Como o Meet identifica um espaço de reunião.
O exemplo de código a seguir mostra como encerrar uma conferência ativa:
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 '{}'
Substitua ACCESS_TOKEN pelo token de acesso que concede acesso à API.
Substitua o valor do nome do espaço pelo ID exclusivo gerado pelo servidor para o espaço de reunião.
Temas relacionados
- Visão geral dos espaços de reunião do Google Meet
- Configurar as opções de espaço para reuniões
- Gerenciar membros do espaço para reuniões
- Trabalhar com conferências