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
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 ressourcespaces
. - 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.
Articles associés
Pour en savoir plus sur le développement avec les API Google Workspace, y compris sur la gestion de l'authentification et des autorisations, consultez Développer sur Google Workspace.
Pour savoir comment créer un espace de réunion avec l'API REST Meet, consultez le guide Utiliser les espaces de réunion.
Pour découvrir comment vous abonner à des événements Google Workspace, consultez S'abonner à des événements à l'aide de l'API Google Workspace Events.