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.

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

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

Vous pouvez également vous abonner à des é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écifié ou à tous les espaces de réunion appartenant à un utilisateur spécifié. Pour en savoir plus, consultez S'abonner à des événements à l'aide de l'API Google Workspace Events et S'abonner aux é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 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 sur 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 de Meet qui peuvent vous être utiles:

  • Gestion des ventes et des comptes

    • Récupérer les informations sur les réunions et les participants à des fins d'enregistrement
    • Récupérez les artefacts des réunions et publiez-les dans les comptes.
    • Exécutez des transcriptions et des enregistrements à l'aide de modèles d'IA pour générer un coaching et une analyse de l'efficacité des ventes.

  • Apprentissage et développement

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

  • Opérations des développeurs

    • Créez des réunions pour communiquer instantanément avec vos collègues.
    • Permettez aux autres personnes concernées de rejoindre les réunions en cours en partageant des informations en temps réel sur les réunions et les participants.
    • Exécuter des données de transcription via des modèles d'IA pour générer les prochaines étapes correctes
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, telles que l'API Chat, à votre application pour renforcer la collaboration. Pour en savoir plus, consultez la section Cas d'utilisation de Chat.

Termes courants

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

Artefact
Fichier généré par Meet en réponse à une conférence, par exemple des enregistrements et des transcripts. En général, un artefact est prêt à être récupéré peu 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 l'organisateur de la réunion, qui contient les informations de connexion à la réunion. Meet peut être la solution de conférence pour cet événement.
Call
Une session utilisant Meet, ou pour avertir les autres participants qu'un appel est en cours ou en cours et leur permettre 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.
Coorganisateur
Personne participant à un appel à qui un organisateur a accordé des droits de gestion par l'organisateur, à l'exception de la possibilité de supprimer l'hôte d'origine.
Hôte
La personne qui a créé l'appel (l'organisateur de la réunion) ou la personne qui contrôle l'appel. Notez qu'un organisateur peut organiser la réunion, mais qu'il n'est pas présent lorsqu'elle a lieu. Un organisateur peut également déléguer des droits d'hôte à un coorganisateur.
Code de réunion

Chaîne unique de 10 caractères pouvant être saisie pour un espace de réunion, utilisée dans son URI 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 peuvent être réutilisés pour d'autres espaces de réunion à l'avenir. En règle générale, 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 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 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 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ù une conférence a lieu. Une seule conférence active peut être organisée dans un même espace à la fois. Un espace de réunion aide également les utilisateurs à se réunir et à trouver des ressources partagées.

URI de la réunion

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

Participant

Une personne ayant rejoint un appel ou qui utilise le mode Compagnon, qui regarde en tant que spectateur ou qu'un appareil de salle connecté à un appel. Une ressource conferenceRecords.participants est disponible pour chaque personne. Lorsqu'un participant rejoint la conférence, un identifiant unique est attribué.

Session participante

Un 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.

Informations d'autorisation et d'authentification spécifiques à l'API

Les champs d'application des autorisations sont les autorisations que vous demandez aux utilisateurs d'autoriser pour que votre application puisse accéder au contenu de la réunion. Lorsqu'un utilisateur installe votre appli, il est invité à valider ces niveaux d'accès. En règle générale, vous devez choisir le champ d'application le plus ciblé possible et éviter de demander des niveaux d'accès dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement un accès à des champs d'application limités et clairement décrits.

L'API REST Meet est compatible avec les champs d'application OAuth 2.0 suivants:

Code du champ d'application Description Utilisation
https://www.googleapis.com/auth/meetings.space.readonly Autoriser les applications à lire les métadonnées de n'importe quel espace de réunion auquel l'utilisateur a accès. Contenu à caractère sensible
https://www.googleapis.com/auth/meetings.space.created Autoriser les applications à créer, modifier et lire les métadonnées sur les espaces de réunion créés par votre application. Contenu à caractère sensible
https://www.googleapis.com/auth/drive.readonly Autoriser les applications à télécharger des fichiers d'enregistrement et de transcription à partir de l'API Google Drive. Limité

Pour en savoir plus sur les champs d'application OAuth 2.0 spécifiques, consultez la page Champs d'application OAuth 2.0 pour les API Google.