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é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 la liste des participants et leurs sessions.
  • Obtenez des artefacts de réunion (enregistrements, transcriptions et entrées de transcriptions).

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écifié ou à tous les espaces de réunion appartenant à un utilisateur donné. 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 conférence selon vos besoins en créant l'espace de réunion. Vous pouvez également gérer les invités et préconfigurer les paramètres.

  • Lors d'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'utilisations de l'API REST Meet:

  • Ventes et gestion 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écuter des transcriptions et des enregistrements via des modèles d'IA pour générer une analyse du coaching et de l'efficacité des ventes ;

  • Apprentissage et développement

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

  • Opérations des développeurs

    • Créez des réunions pour communiquer instantanément avec vos collègues.
    • Permettez aux autres partenaires de rejoindre les réunions en cours en partageant des informations sur les réunions et les participants en temps réel.
    • Exécuter les données de transcription via des modèles d'IA pour générer les étapes suivantes 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 comme l'API Chat à votre application pour aller encore plus loin dans la collaboration. Pour en savoir plus, consultez 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, comme des enregistrements et des transcripts. En général, un artefact est prêt à être récupéré peu de temps après la fin d'une conférence.
Événement d'agenda
Événement Google Agenda avec plusieurs participants, généralement créé par un organisateur de réunion, et contenant les informations de connexion à celle-ci. Meet pourrait être la solution de conférence pour l'événement.
Téléphone
Session utilisant Meet, ou pour avertir d'autres personnes qu'un appel commence ou est en cours, et leur permet de participer immédiatement.
Conférence
Une conférence est une instance d'un appel au sein d'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 à laquelle un hôte a accordé des droits de gestion de l'hôte, à l'exception de la possibilité de supprimer l'hôte d'origine.
Hôte
Personne qui a créé un appel (l'organisateur de la réunion) ou qui contrôle l'appel. Notez que l'organisateur d'une réunion peut l'organiser, mais n'est pas présent lors de celle-ci. Un hôte 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 dans un espace de réunion, utilisée dans l'URL de participation d'un espace de réunion. Par exemple, abc-mnop-xyz. 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 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 permettant d'identifier un espace de réunion. L'ID de réunion est renvoyé dans le champ name d'une ressource spaces.
Organisateur de la réunion
L'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 est possible qu'il ne soit pas présent pendant l'appel ou qu'il s'agisse de 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 (comme une salle de réunion) où se déroule une conférence. Vous ne pouvez tenir qu'une seule conférence active à la fois dans un espace. Un espace de réunion permet également aux utilisateurs de se réunir et de trouver des ressources partagées.
Participant
Personne participant à un appel ou utilisant le mode Compagnon qui regarde en tant que spectateur, ou un appareil de salle connecté à un appel. Il existe une ressource conferenceRecords.participants pour chaque personne. Lorsqu'un participant rejoint la conférence, un identifiant unique 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.

Informations d'autorisation et d'authentification spécifiques aux API

Les champs d'application des autorisations sont les autorisations que vous demandez aux utilisateurs d'accorder à votre application pour accéder au contenu de la réunion. Lorsqu'un utilisateur installe votre application, il est invité à valider ces champs d'application. En règle générale, vous devez choisir le champ d'application le plus précis possible et éviter de demander des champs d'application dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement l'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 sur les espaces de réunion auxquels l'utilisateur a accès. Contenu à caractère sensible
https://www.googleapis.com/auth/meetings.space.created Autorisez 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 depuis l'API Google Drive Limité

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