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, et offre des points d'entrée à vos utilisateurs directement depuis votre application.

Avec l'API REST Meet, vous pouvez effectuer les opérations suivantes :

  • Créer un espace de réunion pour connecter les utilisateurs par vidéo.
  • Obtenir un espace de réunion ou une conférence par nom de ressource.
  • Obtenir une liste des participants et des sessions de participants.
  • Obtenir des artefacts de 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 informé des modifications, vous pouvez vous abonner à un espace de réunion spécifique ou à tous les espaces de réunion appartenant à un utilisateur spécifié. Pour en savoir plus, consultez :

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 la conférence en créant l'espace de réunion. Vous pouvez également gérer les invités 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'utilisation de l'API REST Meet :

  • Ventes et gestion de compte

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

  • Formation 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 étudiants de revoir les supports de cours après la fin du cours.

  • Opérations pour les développeurs

    • Créez des réunions pour connecter instantanément les membres de l'équipe.
    • Permettez à d'autres parties prenantes de participer à des réunions en cours en partageant des informations en temps réel sur les réunions et les participants.
    • Exécutez des données de transcription via des modèles d'IA pour générer les prochaines étapes appropriées.
Créez une réunion dynamique et rejoignez-en une avec vos collègues dans un espace Chat.
Figure 1. Créez une réunion dynamique et participez-y avec vos collègues dans un espace Chat.

Vous pouvez également intégrer d'autres API Google Workspace, comme l'API Chat, dans votre application pour aller encore plus loin dans la collaboration. Pour en savoir plus, consultez la section Cas d'utilisation de 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, tel que recordings et transcripts. Les artefacts sont enregistrés dans le Google Drive de l'organisateur de la réunion. Ils sont généralement prêts à être récupérés 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 la réunion et contenant les informations de participation à une réunion. Meet peut être la solution de conférence pour l'événement.
Appel
Session utilisant Meet, ou notification aux autres qu'un appel commence ou est en cours, et leur permettant de participer immédiatement.
Conférence
Une conférence est une instance d'appel dans un espace de réunion. Les utilisateurs considèrent généralement ce scénario comme une seule réunion.
Enregistrement de conférence
ID unique pour chaque instance d'une conférence. Il est créé automatiquement au début de la conférence. La ressource utilise le format conferenceRecords/{conferenceRecord}.conferenceRecords Par exemple, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Coorganisateur
Personne dans un appel à laquelle un organisateur a accordé des droits de gestion de l'organisateur, à l'exception de la possibilité de supprimer l'organisateur d'origine.
Participer par téléphone
Utiliser un téléphone pour participer à un appel ou écouter un appel diffusé en streaming.
Organisateur
Personne qui a créé un appel (l'organisateur de la réunion) ou 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 des droits d'organisateur à un coorganisateur.
Code de réunion

Chaîne unique de 10 caractères pouvant être saisie pour un espace de réunion utilisé dans l'URI de réunion d'un espace de réunion. Elle n'est pas sensible à la casse. Par exemple, abc-mnop-xyz. Sa 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 être 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

ID unique généré par le serveur et utilisé pour identifier un espace de réunion. Il est sensible à la casse. Par exemple, jQCFfuBOdN5z. L'ID de réunion est renvoyé dans le name champ d'une spaces ressource. Pour en savoir plus, consultez Comment Meet identifie un espace de réunion .

Organisateur de la réunion

Utilisateur qui a créé l'espace de réunion. Cet utilisateur peut également être considéré comme le propriétaire de la réunion. Il peut ne pas être présent pendant l'appel ou être l'organisateur 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 (tel qu'une salle de réunion) où se tient une conférence. Une seule conférence active peut avoir lieu dans un espace à tout moment. Un espace de réunion aide également les utilisateurs à se rencontrer et à trouver des ressources partagées.

URI de réunion

URL cliquable qui démarre ou rejoint un utilisateur à un appel. Chaque appel possède une URL unique composée de https://meet.google.com/ suivi du code de réunion. Par exemple, https://meet.google.com/abc-mnop-xyz.

Participant

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 participants ressource pour chaque personne. Lorsqu'un participant rejoint la conférence, un ID unique lui est attribué.

Session de participant

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

Adresse SIP

Une adresse Session Initiation Protocol (SIP) indique comment le matériel de visioconférence tiers peut trouver et rejoindre une conférence Meet. Meet est compatible avec le schéma d'URI SIP.