Un espace de réunion représente un lieu virtuel ou un objet persistant (comme une salle de réunion) où se tiennent des conférences. Une seule conférence active peut être organisée dans un même espace à la fois. Un espace de réunion permet également aux utilisateurs de se rencontrer et de trouver des ressources partagées.
Les sections suivantes expliquent en détail comment créer, obtenir et mettre à jour un espace de réunion.
Comment Meet identifie un espace de réunion
L'API REST Google Meet génère une ressource spaces
pour chaque espace de réunion. Le champ name
correspond au nom de la ressource.
Voici deux façons importantes d'identifier un espace de réunion à l'aide du champ name
:
space
est l'identifiant de ressource de l'espace, au formatspaces/{space}
. Il s'agit d'un identifiant unique généré par le serveur et sensible à la casse. Par exemple,spaces/jQCFfuBOdN5z
.meetingCode
est un alias de l'espace, au formatspaces/{meetingCode}
. Il s'agit d'une chaîne de caractères unique pouvant être saisie, qui n'est pas sensible à la casse. Par exemple,abc-mnop-xyz
. Il ne doit pas dépasser 128 caractères. Il fait partie demeetingUri
:https://meet.google.com/abc-mnop-xyz
.
Pour gérer un espace de réunion, utilisez les valeurs suivantes dans le champ {name}
:
Pour obtenir des informations sur un espace de réunion, vous pouvez utiliser
spaces/{space}
ou l'aliasspaces/{meetingCode}
. Pour en savoir plus, consultez Obtenir un espace de réunion.Pour mettre à jour les informations d'un espace de réunion, vous ne pouvez utiliser que
spaces/{space}
. Pour en savoir plus, consultez Mettre à jour un espace de réunion.Pour mettre fin à une conférence en cours dans un espace de réunion, vous ne pouvez utiliser que
spaces/{space}
. Pour en savoir plus, consultez Mettre fin à la conférence active.
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
correspondant à 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
Acheter un espace de réunion
Pour obtenir des informations sur un espace de réunion, utilisez la méthode get
sur la ressource spaces
avec un name
spécifié.
Pour en savoir plus, consultez Comment Meet identifie un espace de réunion.
La méthode renvoie un espace de réunion en tant qu'instance de la ressource space
.
L'exemple de code suivant montre comment récupérer un espace de réunion:
Java
Node.js
Python
Remplacez le 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
avec un name
spécifié.
Pour en savoir plus, consultez Comment Meet identifie un espace de réunion.
La méthode patch
accepte également un paramètre updateMask
facultatif. Le champ est de type FieldMask
.
Il s'agit d'une liste de champs à mettre à jour dans l'espace, séparés par une virgule.
La méthode renvoie un espace de réunion en tant qu'instance de la ressource spaces
.
L'exemple de code suivant montre comment mettre à jour un espace de réunion:
Java
Node.js
Python
Remplacez le nom de l'espace par l'ID unique généré par le serveur de l'espace de réunion.
Mettre fin à une conférence active
Pour mettre fin à une conférence active dans un espace de réunion, utilisez la méthode spaces.endActiveConference
sur la ressource spaces
. Le corps de la requête et de la réponse sont vides. Pour en savoir plus, consultez Comment Meet identifie-t-il un espace de réunion ?
L'exemple de code suivant montre comment mettre fin à une conférence active:
Java
Node.js
Python
Remplacez le nom de l'espace par l'ID unique généré par le serveur de l'espace de réunion.