En esta guía, se explica cómo crear, obtener y actualizar un espacio de reunión, además de cómo finalizar una conferencia activa en el recurso spaces de la API de REST de Google Meet.
Crea un espacio de reunión
Para crear un espacio de reunión, usa el método create en el recurso spaces.
El método devuelve una instancia de un recurso spaces, que incluye el objeto SpaceConfig, que es la configuración de la sala de reuniones. También contiene el objeto ActiveConference, que es un vínculo al recurso conferenceRecords actual dentro de la sala de reuniones.
En el siguiente ejemplo de código, se muestra cómo crear un espacio de reunión:
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 '{}'
Reemplaza ACCESS_TOKEN por el token de acceso que otorga acceso a la API.
Obtén una sala de reuniones
Para obtener detalles sobre un espacio de reunión activo y su configuración, usa el método get en el recurso spaces. Configura el parámetro de ruta de acceso name con el formato spaces/{space} o spaces/{meetingCode}. Para obtener más información, consulta Cómo identifica Meet un espacio de reunión.
El método devuelve un espacio de reunión como una instancia del recurso spaces. Para determinar si existe una conferencia activa, examina el campo activeConference.
En la siguiente muestra de código, se muestra cómo recuperar un espacio de reunión:
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"
Reemplaza ACCESS_TOKEN por el token de acceso que otorga acceso a la API.
Reemplaza el valor del nombre del espacio por el ID único generado por el servidor para el espacio de reunión.
Actualiza un espacio de reunión
Para actualizar los detalles de un espacio de reunión, usa el método patch en el recurso spaces. Establece el parámetro de ruta space.name con el formato spaces/{space}. Para obtener más información, consulta Cómo identifica Meet un espacio de reunión.
El método patch también toma un parámetro de búsqueda updateMask opcional. El campo es del tipo FieldMask.
Es una lista de los campos que deseas actualizar en el espacio, separados por comas.
El método devuelve un espacio de reunión como una instancia del recurso spaces.
En el siguiente ejemplo de código, se muestra cómo actualizar un espacio de reunión:
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"
}
}'
Reemplaza ACCESS_TOKEN por el token de acceso que otorga acceso a la API.
Reemplaza el valor del nombre del espacio por el ID único generado por el servidor para el espacio de reunión.
Cómo finalizar una conferencia activa
Para finalizar una conferencia activa en un espacio de reunión (si hay uno), usa el método endActiveConference en el recurso spaces.
Establece el parámetro de ruta name con el formato spaces/{space}. Tanto el cuerpo de la solicitud como el de la respuesta están vacíos. Para obtener más información, consulta Cómo identifica Meet un espacio de reunión.
En el siguiente ejemplo de código, se muestra cómo finalizar una conferencia activa:
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 '{}'
Reemplaza ACCESS_TOKEN por el token de acceso que otorga acceso a la API.
Reemplaza el valor del nombre del espacio por el ID único generado por el servidor para el espacio de reunión.
Temas relacionados
- Descripción general de los espacios de reuniones de Google Meet
- Cómo configurar los parámetros del espacio de reunión
- Administra los miembros del espacio de reunión
- Trabaja con conferencias