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. Un espace de réunion permet également aux utilisateurs de se rencontrer et de trouver des ressources partagées.
Lorsque vous créez un espace de réunion à l'aide de la méthode spaces.create, elle renvoie une instance d'une ressource spaces. La ressource 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.
Les sections suivantes expliquent comment configurer un espace de réunion à l'aide de plusieurs nouveaux objets et méthodes bêta.
Définir la modération et l'accès aux réunions
Grâce aux nouveaux objets bêta, vous pouvez désormais définir des modes de modération, des restrictions de fonctionnalités et les autorisations que les utilisateurs reçoivent lorsqu'ils rejoignent une réunion. Ils sont définis via l'objet SpaceConfig mis à jour.
Le champ moderation est un mode de modération préconfiguré pour une réunion, dont la valeur par défaut est contrôlée par les règles de l'utilisateur. Elle utilise l'objet Moderation. Lorsque le mode modération est activé, le propriétaire de la réunion contrôle la réunion avec des fonctionnalités telles que la gestion des co-animateurs (voir spaces.members) et les restrictions de fonctionnalités (voir moderationRestrictions). Pour en savoir plus sur les membres, consultez Gérer les membres de l'espace.
Le champ moderationRestrictions applique les restrictions de modération à la réunion lorsque moderation est activé. Elle utilise l'objet ModerationRestrictions. Les restrictions définissent qui est autorisé à envoyer des messages et des réactions dans le chat, à partager son écran, et si le rôle par défaut attribué aux utilisateurs doit être celui de spectateur. Le champ moderationRestrictions s'appuie sur un RestrictionType pour appliquer les trois premières restrictions. RestrictionType peut être appliqué au propriétaire et au coorganisateur de la réunion, ou à tous les participants. DefaultJoinAsViewerType applique l'autorisation finale lorsque les utilisateurs rejoignent une session en tant que contributeurs par défaut, mais que les hôtes peuvent également les limiter à rejoindre la session en tant que spectateurs.
Le champ firstJoinerType indique si les utilisateurs peuvent rejoindre les conférences de cet espace de réunion avant l'hôte. Il définit les utilisateurs qui peuvent rejoindre la réunion en premier et si d'autres sont en attente. Elle utilise l'objet FirstJoinerType.
Gérer les membres de l'espace
Un organisateur de réunion pouvait toujours y accéder sans demander à y participer, mais vous pouvez désormais configurer des membres qui peuvent également y accéder sans demander à y participer. De plus, les membres peuvent être configurés pour avoir un rôle dans la réunion, par exemple COHOST, ce qui leur donne les mêmes droits de gestion de la réunion que le propriétaire. Pour en savoir plus sur l'accès à un espace de réunion sans frapper, consultez AccessType.
La ressource spaces.members inclut les champs name, user et role.
Notez qu'un membre est différent d'un participant. Un participant est une personne qui a rejoint un appel ou qui utilise le mode Compagnon, qui regarde en tant que spectateur ou un appareil de salle connecté à un appel. Une ressource conferenceRecords.participants est attribuée à chaque personne.
Vous pouvez gérer les membres de l'espace à l'aide des méthodes suivantes:
Chaque méthode accepte un paramètre de chemin d'accès, les méthodes de création et de liste utilisant le champ parent pour désigner l'espace de réunion, et les méthodes de suppression et d'obtention utilisant le champ name pour filtrer les résultats en fonction de l'espace de réunion et du nom du membre.
Toutes les méthodes, à l'exception de la suppression, acceptent le paramètre fields dans SystemParameterContext. Lorsque le paramètre fields est omis, la réponse de l'API est définie par défaut sur "name,email,role,user".
Le paramètre fields repose sur un FieldMask pour le filtrage des réponses. Un FieldMask permet aux appelants d'API de lister les champs qu'une requête doit renvoyer. Il s'agit d'une liste de champs séparés par une virgule pour spécifier que seuls certains champs d'un objet sont utilisés, en laissant les autres champs inchangés.
L'utilisation d'un FieldMask permet à l'API d'éviter les tâches inutiles et d'améliorer les performances. Un masque de champ est utilisé pour les méthodes create, get et list. Pour en savoir plus sur les masques de champ, consultez la section Utiliser des masques de champ de l'API Google Sheets.