Ce guide explique comment créer, obtenir et mettre à jour un espace de réunion, et comment mettre fin à une conférence active sur la ressource spaces de l'API REST Google Meet.
Créer un espace de réunion
Pour créer un espace de réunion, utilisez la méthode create sur la ressource spaces.
La méthode renvoie une instance d'une ressource spaces, qui inclut l'objet SpaceConfig qui correspond à la configuration de l'espace de réunion. Il contient également l'objet ActiveConference qui est un lien vers la ressource conferenceRecords actuelle dans l'espace de réunion.
L'exemple de code suivant montre comment créer un espace de réunion :
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 '{}'
Remplacez ACCESS_TOKEN par le jeton d'accès qui permet d'accéder à l'API.
Obtenir un espace de réunion
Pour obtenir des informations sur un espace de réunion actif et ses paramètres, utilisez la méthode get sur la ressource spaces. Définissez le paramètre de chemin d'accès name au format spaces/{space} ou spaces/{meetingCode}. Pour en savoir plus, consultez Comment Meet identifie un espace de réunion.
La méthode renvoie un espace de réunion sous la forme d'une instance de la ressource spaces. Pour déterminer si une conférence active existe, examinez le champ activeConference.
L'exemple de code suivant montre comment récupérer un espace de réunion :
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"
Remplacez ACCESS_TOKEN par le jeton d'accès qui permet d'accéder à l'API.
Remplacez la valeur du nom de l'espace par l'ID unique généré par le serveur pour l'espace de réunion.
Modifier un espace de réunion
Pour mettre à jour les détails d'un espace de réunion, utilisez la méthode patch sur la ressource spaces. Définissez le paramètre de chemin d'accès space.name au format spaces/{space}. Pour en savoir plus, consultez Comment Meet identifie un espace de réunion.
La méthode patch accepte également un paramètre de requête updateMask facultatif. Le champ est de type FieldMask.
Il s'agit d'une liste de champs que vous souhaitez mettre à jour dans l'espace, séparés par une virgule.
La méthode renvoie un espace de réunion sous la forme d'une instance de la ressource spaces.
L'exemple de code suivant montre comment mettre à jour un espace de réunion :
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"
}
}'
Remplacez ACCESS_TOKEN par le jeton d'accès qui permet d'accéder à l'API.
Remplacez la valeur du nom de l'espace par l'ID unique généré par le serveur pour l'espace de réunion.
Mettre fin à une visioconférence en cours
Pour mettre fin à une visioconférence active dans un espace de réunion (le cas échéant), utilisez la méthode endActiveConference sur la ressource spaces.
Définissez le paramètre de chemin d'accès name au format spaces/{space}. Le corps de la requête et celui de la réponse sont vides. Pour en savoir plus, consultez Comment Meet identifie un espace de réunion.
L'exemple de code suivant montre comment mettre fin à une conférence active :
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 '{}'
Remplacez ACCESS_TOKEN par le jeton d'accès qui permet d'accéder à l'API.
Remplacez la valeur du nom de l'espace par l'ID unique généré par le serveur pour l'espace de réunion.
Articles associés
- Présentation des espaces de réunion Google Meet
- Configurer les paramètres d'un espace de réunion
- Gérer les membres d'un espace de réunion
- Utiliser les conférences