Présentation des espaces de réunion Google Meet

Illustration de l'API REST Google Meet

Ce guide explique comment l'API REST Google Meet vous permet de créer et de gérer des réunions pour Google Meet.

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. Vous ne pouvez organiser qu'une seule conférence active à la fois dans un espace. Un espace de réunion permet également aux utilisateurs de se rencontrer et de trouver des ressources partagées.

Pour utiliser les espaces de réunion, consultez Créer et gérer des espaces de réunion. Pour savoir comment configurer un espace de réunion de manière programmatique, consultez Configurer des espaces de réunion et des membres.

Appeler les méthodes de l'espace de réunion

Le tableau suivant détaille les rôles requis pour utiliser les méthodes de l'espace de réunion :

Méthode Propriétaires Participants Autres
endActiveConference x
get x x x
     avec des paramètres x
     avec une conférence active x x
patch x

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. La ressource spaces offre plusieurs points d'entrée pour rejoindre une conférence.

Le tableau suivant montre comment identifier et rejoindre un espace de réunion :

Nom du champ Description
name Nom de l'espace. La chaîne {space} est l'identifiant de ressource de l'espace et est formatée comme spaces/{space}. Il s'agit d'un ID unique généré par le serveur. Il est sensible à la casse. Exemple : spaces/jQCFfuBOdN5z
meetingCode Alias du nom de l'espace. {meetingCode} est une chaîne de caractères unique et saisissable, et n'est pas sensible à la casse. Elle est mise en forme comme suit : spaces/{meetingCode}. Exemple : spaces/abc-mnop-xyz La longueur ne doit pas dépasser 128 caractères. Il fait partie de meetingUri : https://meet.google.com/abc-mnop-xyz.
phoneAccess Méthodes d'accès par téléphone pour cet espace de réunion. L'objet phoneAccess contient les informations requises pour se connecter à une conférence, y compris les numéros de téléphone régionaux pour l'espace de réunion et un code d'accès spécifique à ce numéro de téléphone. Le code ne contient que des chiffres décimaux et sa longueur peut varier. Par exemple, "pin": 19707127300.

Comme l'UI Meet, la ressource spaces inclut un ensemble limité de numéros de téléphone. Pour afficher d'autres numéros de téléphone pour un espace de réunion, ajoutez {meetingCode} à l'URL suivante : https://meet.google.com/tel/. Par exemple, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess Méthodes d'accès au protocole SIP (Session Initiation Protocol) pour cet espace de réunion. Une adresse SIP indique comment le matériel de visioconférence tiers peut trouver et rejoindre une conférence Meet. L'objet gatewaySipAccess contient un URI et un code d'accès numérique. Meet est compatible avec le schéma d'URI SIP.

Pour gérer un espace de réunion, utilisez les valeurs suivantes pour le champ name :

  • Pour obtenir des informations sur un espace de réunion, vous pouvez utiliser spaces/{space} ou l'alias spaces/{meetingCode}. Pour en savoir plus, consultez Obtenir un espace de réunion.

  • Pour modifier les détails d'un espace de réunion, vous ne pouvez utiliser que spaces/{space}. Pour en savoir plus, consultez Modifier un espace de réunion.

  • Pour mettre fin à une visioconférence active dans un espace de réunion, vous ne pouvez utiliser que spaces/{space}. Pour en savoir plus, consultez Mettre fin à une visioconférence active.

Cycle de vie d'un espace de réunion

Un espace de réunion passe par plusieurs états au cours de son cycle de vie. Le diagramme suivant illustre les étapes générales du cycle de vie d'un espace de réunion :

Cycle de vie des espaces de réunion.
Figure 1. Cycle de vie d'un espace de réunion

  1. Appelez spaces.create. L'espace de réunion est créé et l'objet spaces renvoyé contient la chaîne meetingUri. Le meetingUri est ensuite distribué aux participants.

  2. Sondez le nouvel espace de réunion. Appelez la méthode spaces.get pour vérifier l'état de la conférence.

    Au lieu d'interroger l'API, vous pouvez également vous abonner aux événements Meet pour recevoir des notifications push.

  3. Démarrez la visioconférence. Lorsqu'un participant clique sur meetingUri dans l'espace de réunion, une conférence commence. L'objet activeConference est renseigné et la chaîne activeConference.conferenceRecord est définie.

  4. (Facultatif) Obtenez les données de la conférence. Lors d'une conférence active, vous pouvez accéder à certaines valeurs conferenceRecord. Par exemple, appelez la méthode conferenceRecords.participants.list pour afficher tous les participants à la conférence. Vous pouvez également accéder à ces informations jusqu'à 30 jours après la conférence.

  5. (Facultatif) Mettez fin à la conférence. Pendant la conférence, le propriétaire de la réunion peut appeler la méthode spaces.endActiveConference pour mettre fin de manière programmatique à une conférence active pour tous les participants.

  6. La conférence se termine. Lorsque le dernier participant quitte la visioconférence, celle-ci se termine.

  7. Interrogez les artefacts post-conférence. La conférence est terminée (STATE=ENDED), mais les artefacts n'ont pas encore été générés. Les startTime et endTime de la conférence sont également renseignés. Vous devez interroger le point de terminaison de l'artefact jusqu'à ce que l'objet d'artefact STATE indique FILE_GENERATED.

    Au lieu d'interroger les événements Meet, vous pouvez vous y abonner pour recevoir des notifications push.

  8. Obtenir les artefacts post-conférence Vous pouvez récupérer des artefacts tels que des enregistrements et des transcriptions une fois qu'ils ont été générés. Par exemple, appelez la méthode conferenceRecords.recordings.get pour obtenir un enregistrement par ID d'enregistrement.

    Une fois prêt, un URI vers l'objet d'artefact est renseigné et renvoyé dans l'objet de ressource.