Un espace de réunion représente un lieu virtuel ou un objet persistant (comme une salle de réunion) où se tiennent les 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 façon dont les utilisateurs rejoignent une réunion, les modes de modération, les restrictions de fonctionnalités et les autorisations dont ils bénéficient lorsqu'ils rejoignent une réunion, grâce à l'objet SpaceConfig.
Accéder aux espaces de réunion
Pour déterminer qui peut rejoindre un espace de réunion sans demander à le rejoindre, définissez le champ accessType à l'aide de l'objet AccessType. Vous pouvez choisir parmi plusieurs paramètres pour autoriser automatiquement les participants à rejoindre la réunion. Par défaut, le champ reprend les paramètres d'accès par défaut de l'utilisateur.
Pour définir les points d'entrée qui peuvent être utilisés pour rejoindre des réunions organisé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 sur CREATOR_APP_ONLY pour limiter les points d'entrée à ceux appartenant au projet Google Cloud qui a créé l'espace de réunion.
Générer un rapport de participation
Pour créer un rapport de présence pour 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 le 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 défini sur on, l'organisateur de la réunion contrôle la réunion à l'aide de fonctionnalités telles que la gestion des coorganisateurs (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 d'un espace.
Pour définir des restrictions de fonctionnalités lorsque la réunion est modérée (moderation est défini sur on), définissez le champ moderationRestrictions à l'aide de l'objet ModerationRestrictions. Les restrictions définissent qui est autorisé dans l'espace de réunion à envoyer des messages de chat ou des réactions, ou à partager son écran.
Pour définir les restrictions de fonctionnalités sur le champ moderationRestrictions, utilisez l'énumération RestrictionType pour appliquer chatRestriction, reactionRestriction et presentRestriction. Définissez la valeur sur HOSTS_ONLY pour appliquer les autorisations à l'organisateur et au coorganisateur 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 à celui de lecteur, 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 réunion en tant que spectateurs. Si off, les utilisateurs rejoignent l'espace 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, il rejoint la réunion avec ce rôle.
Gérer les artefacts automatiques
Les organisateurs de réunions, mais pas les coorganisateurs, peuvent préconfigurer l'enregistrement automatique, la transcription automatique et la fonctionnalité 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 pour chaque 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 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 niveaux d'accès OAuth suivants :
| Cas d'utilisation | Code du 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 |
| Obtenez ou listez les artefacts des conférences créées par d'autres applications. | https://www.googleapis.com/auth/meetings.space.readonly |
| Obtenez ou listez les autres paramètres avant 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 depuis n'importe quelle autre application, comme Agenda | https://www.googleapis.com/auth/meetings.space.settings |
Pour en savoir plus sur les champs d'application OAuth, consultez Découvrir les champs d'application de l'API REST Meet.
Gérer les membres d'un espace
Les organisateurs de réunions peuvent toujours y accéder sans avoir à demander à y participer. Vous pouvez également configurer d'autres membres pour qu'ils puissent rejoindre la réunion sans avoir à demander à y participer. De plus, les membres peuvent se voir attribuer un rôle dans la réunion, comme COHOST, qui leur donne les mêmes droits de gestion que l'organisateur de la réunion. Pour savoir comment accéder à un espace de réunion sans frapper à la porte, 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 qui utilise un appareil de salle connecté à un appel. Il existe une ressource conferenceRecords.participants pour chaque personne.
Vous pouvez gérer les membres d'un espace à l'aide des méthodes suivantes :
Chaque méthode utilise un paramètre de chemin d'accès. Les méthodes de création et de liste utilisent le champ parent pour désigner l'espace de réunion, tandis que les méthodes de suppression et d'obtention utilisent 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, sont compatibles avec 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 permettant de spécifier que seuls certains champs d'un objet sont utilisés, tandis que les autres restent 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.