Présentation de l'API REST Google Meet

L'API REST Google Meet vous permet de créer et de gérer des réunions pour Google Meet. Elle offre également des points d'entrée à vos utilisateurs directement depuis votre application.

L'API REST Meet vous permet d'effectuer les opérations suivantes:

  • Créez un espace de réunion pour mettre en relation des utilisateurs par visioconférence.
  • Obtenez un espace de réunion ou une conférence par nom de ressource.
  • Obtenez la liste des participants et de leurs sessions.
  • Obtenir les artefacts de la réunion (enregistrements, transcriptions et entrées de transcription)

Vous pouvez également vous abonner aux événements Meet à l'aide de l'API Google Workspace Events. Pour être averti des modifications, vous pouvez vous abonner à un espace de réunion spécifique ou à tous les espaces de réunion appartenant à un utilisateur spécifique. Pour en savoir plus, consultez S'abonner à des événements à l'aide de l'API Google Workspace Events et S'abonner à des événements Google Meet.

Cas d'utilisation

Les applications peuvent s'intégrer à l'API REST Meet pour effectuer les tâches suivantes:

  • Avant une conférence: personnalisez l'expérience de conférence si nécessaire en créant l'espace de réunion. Vous pouvez également gérer les personnes invitées et préconfigurer les paramètres.

  • Pendant une conférence: récupérez les informations de la conférence pour modifier l'expérience de votre application en fonction des métadonnées renvoyées.

  • Après une conférence: récupérez les artefacts de la conférence, tels que l'enregistrement et la transcription.

Voici quelques exemples d'utilisations de l'API REST Meet:

  • Vente et gestion des comptes

    • Récupérer des informations sur la réunion et les participants à des fins d'enregistrement
    • Récupérez les artefacts de réunion et les publiez dans les comptes.
    • Exécutez des transcriptions et des enregistrements via des modèles d'IA pour générer des analyses de coaching et d'efficacité des ventes.

  • Apprentissage et développement

    • Créez et préconfigurez des réunions pour la formation.
    • Attribuez des rôles de coorganisateur aux formateurs et aux responsables de session.
    • Récupérez les enregistrements qui permettent aux élèves de revoir les supports après la fin du cours.

  • Opérations pour les développeurs

    • Créez des réunions pour mettre en relation instantanément vos coéquipiers.
    • Permettez à d'autres personnes concernées de rejoindre des réunions en cours en partageant des informations sur la réunion et les participants en temps réel.
    • Exécutez les données de transcription via des modèles d'IA pour générer les prochaines étapes appropriées.
Créez et rejoignez une réunion dynamique avec vos collègues dans un espace Chat.
Figure 1 Créez et rejoignez une réunion dynamique avec vos collègues dans un espace Chat.

Vous pouvez également intégrer d'autres API Google Workspace, comme l'API Chat, à votre application pour optimiser la collaboration. Pour en savoir plus, consultez la section Cas d'utilisation du chat.

Termes courants

Voici une liste des termes courants utilisés dans cette API:

Artefact
Fichier généré par Meet en réponse à une conférence, comme des enregistrements et des transcriptions. En général, un artefact est prêt à être extrait peu de temps après la fin d'une conférence.
Événement d'agenda
Événement dans Google Agenda avec plusieurs participants, généralement créé par un organisateur de réunion, contenant les informations de connexion à une réunion. Meet peut être la solution de conférence pour l'événement.
Appeler
Une session avec Meet, ou pour avertir d'autres personnes qu'un appel commence ou est en cours et leur permettre de le rejoindre immédiatement.
Conférence
Une conférence est une instance d'un appel dans un espace de réunion. Les utilisateurs considèrent généralement ce scénario comme une seule réunion.
Coorganisateur
Personne participant à un appel à qui un organisateur a accordé des droits de gestion, à l'exception de la possibilité de supprimer l'organisateur d'origine.
Hôte
Personne qui a créé un appel (organisateur de la réunion) ou personne qui contrôle l'appel. Notez qu'un organisateur de réunion peut organiser la réunion, mais ne pas être présent lorsqu'elle a lieu. Un organisateur peut également déléguer ses droits à un coorganisateur.
Code de la réunion

Chaîne unique de 10 caractères pouvant être saisie pour un espace de réunion utilisée dans l'URI de la réunion d'un espace de réunion. Il n'est pas sensible à la casse. Exemple : abc-mnop-xyz. La longueur maximale est de 128 caractères.

Les codes de réunion ne doivent pas être stockés à long terme, car ils peuvent être dissociés d'un espace de réunion et réutilisés pour différents espaces de réunion à l'avenir. En général, les codes de réunion expirent 365 jours après leur dernière utilisation. Pour en savoir plus, consultez En savoir plus sur les codes de réunion dans Google Meet.

Nom de la réunion

Identifiant unique généré par le serveur permettant d'identifier un espace de réunion. Il est sensible à la casse. Exemple :jQCFfuBOdN5z L'ID de réunion est renvoyé dans le champ name d'une ressource spaces.

Organisateur de la réunion

Utilisateur ayant créé l'espace de réunion. Cet utilisateur peut également être considéré comme le propriétaire de la réunion. Il se peut qu'il ne soit pas présent pendant l'appel ou qu'il ne soit pas l'hôte de la réunion. Il ne peut y avoir qu'un seul organisateur de réunion.

Espace de réunion

Lieu virtuel ou objet persistant (comme une salle de réunion) où se tient une conférence. Une seule conférence active peut être organisée dans un même espace à la fois. Un espace de réunion permet également aux utilisateurs de se rencontrer et de trouver des ressources partagées.

URI de la réunion

URL cliquable qui lance ou joint un utilisateur à un appel. Chaque appel dispose d'une URL unique composée de https://meet.google.com/, suivi du code de la réunion. Par exemple, https://meet.google.com/abc-mnop-xyz.

Participant

Personne ayant rejoint un appel ou qui utilise le mode Compagnon, regardant l'appel en tant que spectateur ou appareil de salle connecté à un appel. Une ressource conferenceRecords.participants est attribuée à chaque personne. Lorsqu'un participant rejoint la conférence, un ID unique lui est attribué.

Session du participant

ID de session unique créé pour chaque paire participant-appareil qui rejoint un appel. Il existe une ressource conferenceRecords.participants.participantSessions pour chaque session. Si le participant rejoint le même appel plusieurs fois à partir de la même paire participant-appareil, des ID de session uniques lui sont attribués.