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 Créer et gérer des espaces de réunion.
Les sections suivantes expliquent comment configurer un espace de réunion à l'aide de ces objets et méthodes.
Définir la modération et l'accès aux réunions
Vous pouvez définir la manière dont les utilisateurs rejoignent une réunion, les modes de modération, les restrictions de fonctionnalités et les autorisations qu'ils reçoivent lorsqu'ils rejoignent une réunion à l'aide de l'objet SpaceConfig.
Accéder aux espaces de réunion
Pour déterminer qui peut rejoindre un espace de réunion sans demander l'autorisation, définissez le champ accessType à l'aide de l'objet AccessType.
Vous pouvez choisir parmi plusieurs paramètres pour autoriser ou non automatiquement les participants à rejoindre la réunion. Par défaut, le champ utilise les paramètres d'accès par défaut de l'utilisateur.
Pour définir les points d'entrée permettant de rejoindre les réunions hébergées dans un espace de réunion, définissez le champ entryPointAccess à l'aide de l'objet EntryPointAccess. Définissez la valeur sur ALL pour autoriser tous les points d'entrée ou CREATOR_APP_ONLY pour limiter les points d'entrée à ceux appartenant au projet Google Cloud ayant créé l'espace de réunion.
Générer un rapport sur la participation
Pour créer un rapport sur la participation à l'espace de réunion, définissez le champ booléen attendanceReportGenerationType à l'aide de l'objet AttendanceReportGenerationType. Si un rapport est demandé, Google Meet l'enregistre dans Google Drive de l'organisateur de la réunion et envoie également un e-mail.
Modérer les espaces de réunion
Pour modérer une réunion, vous pouvez définir le champ booléen moderation à l'aide de l'objet Moderation.
Lorsque le mode moderation est on, 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 à l'aide du champ moderationRestrictions. Pour en savoir plus sur les membres, consultez Gérer les membres de l'espace.
Pour définir des restrictions de fonctionnalités lorsque la réunion est modérée (moderation est on), définissez le champ moderationRestrictions à l'aide de l'objet ModerationRestrictions. Les restrictions définissent les personnes autorisées à envoyer des messages ou des réactions dans l'espace de réunion, ou à partager leur écran.
Pour définir les restrictions de fonctionnalité sur le champ moderationRestrictions, utilisez l'énumération RestrictionType pour appliquer les valeurs chatRestriction, reactionRestriction et presentRestriction. Définissez la valeur sur HOSTS_ONLY pour appliquer les autorisations à l'organisateur et au co-organisateur de la réunion, ou sur NO_RESTRICTION pour les appliquer à tous les participants.
Pour limiter le rôle par défaut attribué aux utilisateurs en tant que lecteurs, définissez le champ booléen defaultJoinAsViewerType à l'aide de l'énumération DefaultJoinAsViewerType. Si defaultJoinAsViewerType est défini sur on, les utilisateurs rejoignent la session en tant que spectateurs. Si off, les utilisateurs rejoignent en tant que contributeurs. La valeur par défaut est off Si un rôle explicite est défini pour un utilisateur dans spaces.members, l'utilisateur rejoint le groupe avec ce rôle.
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 enregistré, des transcriptions sont générées, et les notes de réunion sont capturées et organisées automatiquement 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 à partir de 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.
Pour définir des artefacts automatiques, utilisez l'objet ArtifactConfig sous l'objet SpaceConfig. ArtifactConfig est composé des champs recordingConfig, transcriptionConfig et smartNotesConfig.
Chaque champ est mappé à un objet similaire, tel que RecordingConfig, TranscriptionConfig et SmartNotesConfig. Pour définir chaque objet, utilisez l'énumération booléenne AutoGenerationType pour activer ou désactiver l'objet de configuration on ou off.
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 Champs d'application de l'API REST.
Gérer les membres de l'espace
Bien que les organisateurs de réunion puissent toujours y accéder sans demander à y participer, vous pouvez également configurer des membres supplémentaires pour qu'ils puissent y participer 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.