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. Pour en savoir plus sur la gestion d'un espace de réunion, consultez la section Utiliser des espaces 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é, l'organisateur de la réunion contrôle la réunion avec des fonctionnalités telles que la gestion des co-organisateurs (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é à l'organisateur 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 rejoindre la réunion sans demander à y participer, mais vous pouvez désormais configurer des membres qui peuvent également rejoindre la réunion 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 l'organisateur. 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 s'appuie 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, tout 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.
Gérer les artefacts automatiques
Les organisateurs de réunion, mais pas les coorganisateurs, peuvent préconfigurer l'enregistrement automatique, les transcriptions automatiques et l'option "Prendre des notes pour moi" dans l'espace de réunion. Lorsque ces paramètres sont activés, l'espace de réunion est automatiquement enregistré, des transcriptions sont générées, et les notes de réunion sont automatiquement capturées et organisées dans Google Docs. Chaque fonctionnalité est indépendante et est définie par espace de réunion. Les sous-titres des enregistrements ne sont disponibles qu'en anglais.
Vous pouvez préconfigurer les artefacts automatiques lorsque vous créez un espace de réunion ou une fois l'espace de réunion créé. Cette fonctionnalité vous permet également de configurer des artefacts automatiques pour les réunions créées dans Google Agenda. Les deux méthodes nécessitent le champ d'application OAuth meetings.space.settings. Pour en savoir plus, consultez la section Champs d'application OAuth pour les paramètres.
Les artefacts automatiques sont définis via l'objet ArtifactConfig, sous l'objet SpaceConfig, qui fait partie de la ressource spaces. ArtifactConfig est composé des champs recordingConfig, transcriptionConfig et smartNotesConfig.
Chaque champ est mappé à un objet similaire, tel que RecordingConfig, TranscriptionConfig et SmartNotesConfig. Chaque objet est défini à l'aide de l'énumération booléenne AutoGenerationType pour activer ou désactiver l'objet de configuration.
Champs d'application OAuth pour les paramètres
Pour définir ou accéder aux paramètres des réunions, vous devez disposer des champs d'application OAuth suivants:
| Cas d'utilisation | Code de champ d'application |
|---|---|
| Définissez la génération automatique d'artefacts pour les espaces créés par d'autres applications. | https://www.googleapis.com/auth/meetings.space.settings |
| Obtenir ou lister des artefacts de conférences créées par d'autres applications | https://www.googleapis.com/auth/meetings.space.readonly |
| Obtenir ou lister d'autres paramètres de préréunion d'un espace de réunion créé par une application tierce | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Lire et modifier les paramètres de tous les espaces de réunion auxquels un utilisateur peut accéder via une autre application, comme Agenda. | https://www.googleapis.com/auth/meetings.space.settings |
Pour en savoir plus sur les champs d'application OAuth, consultez la section Connaître les champs d'application de l'API REST.