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 Meet REST vous permet d'effectuer les opérations suivantes :

  • Créez et configurez des espaces de réunion pour permettre aux utilisateurs de communiquer par vidéo.
  • Préconfigurez les niveaux d'accès aux espaces, les paramètres de modération, ainsi que les enregistrements ou les transcriptions automatiques.
  • gérer les membres d'un espace de réunion et attribuer des rôles d'organisateur adjoint ;
  • Mettre fin à une conférence active de manière programmatique dans un espace de réunion.
  • Obtenez les enregistrements des conférences, les détails de la participation et les métadonnées des sessions des participants.
  • Récupérer les artefacts de réunion (enregistrements, transcriptions, entrées de transcription et notes intelligentes)

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 donné. Pour en savoir plus, consultez les pages suivantes :

Cas d'utilisation

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

  • Avant une visioconférence : créez des espaces de réunion à la demande, préconfigurez les restrictions d'accès (ouvert, fiable ou restreint), appliquez des contrôles de modération (partage d'écran, chat, réactions, micro et caméra), configurez l'enregistrement ou la transcription automatiques, et attribuez des rôles d'organisateur aux membres de l'espace.

  • Pendant une visioconférence : récupérez les métadonnées de la visioconférence active et les sessions des participants, gérez les membres de manière dynamique, écoutez les événements de cycle de vie en temps réel à l'aide de l'API Google Workspace Events ou mettez fin à la visioconférence active de manière programmatique.

  • Après une conférence : récupérez les enregistrements et les journaux de présence, téléchargez les enregistrements, les transcriptions Google Docs et les notes intelligentes depuis Google Drive, et accédez aux entrées vocales détaillées des transcriptions pour le coaching, la conformité ou l'analyse par l'IA.

Voici quelques exemples d'actions que vous pouvez effectuer avec l'API REST Meet :

  • Ventes et gestion des comptes

    • Récupérer des informations sur les réunions et les participants à des fins d'archivage.
    • 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 de coaching et d'efficacité des ventes.

  • Formation et développement

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

  • Assistance client et conseil

    • Créez des espaces de réunion sécurisés et restreints directement à partir des demandes d'assistance ou des portails clients.
    • Préconfigurez la gestion par l'organisateur pour que seuls les agents du service client puissent présenter ou gérer la présence.
    • Activez l'enregistrement ou la transcription automatiques pour les enregistrements d'assurance qualité et de conformité.
    • Mettre fin aux conférences actives de manière programmatique lorsque des rendez-vous ou des sessions d'assistance se terminent.

  • Opérations pour les développeurs

    • Créez des réunions pour échanger instantanément avec vos coéquipiers.
    • Permettez à d'autres parties prenantes de rejoindre des réunions en cours en partageant des informations en temps réel sur les réunions et les participants.
    • Exécutez les données de transcription dans 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 rejoignez-en une 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 améliorer encore davantage la collaboration. Pour en savoir plus, consultez Cas d'utilisation du chat.

Termes courants

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

Conférence active
 Conférence en cours dans un espace de réunion. À tout moment, un espace de réunion ne peut accueillir qu'une seule conférence active. Une fois la conférence terminée, elle devient un enregistrement historique.
Artefact
 Fichier généré par Meet en réponse à une conférence, tel que recordings, transcripts et smartNotes. Les artefacts sont enregistrés dans le 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 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.
Call
Une session Meet, ou pour informer d'autres personnes qu'un appel commence ou est en cours, et leur permettre de le rejoindre immédiatement.
Coorganisateur
Personne dans un appel à qui un organisateur a accordé des droits de gestion, à l'exception de la possibilité de supprimer l'organisateur d'origine.
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.
Record de la conférence
Identifiant unique pour chaque instance d'une conférence. Il est créé automatiquement au début de la conférence. La ressource conferenceRecords utilise le format conferenceRecords/{conferenceRecord}. Par exemple, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Participer par téléphone
Pour participer à un appel ou écouter un appel en streaming depuis un téléphone.
Hôte
La personne qui a créé un appel (l'organisateur de la réunion) ou celle 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é dans l'URI de réunion d'un espace de réunion. Il n'est pas sensible à la casse. Exemple : abc-mnop-xyz. La longueur ne doit pas dépasser 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

ID unique généré par le serveur et utilisé pour 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. Pour en savoir plus, consultez Comment Meet identifie un espace de réunion.

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 se peut qu'il ne soit pas présent pendant l'appel ou qu'il ne soit pas 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 tient une conférence. Vous ne pouvez organiser qu'une seule conférence active à la fois dans un espace. 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 permet à un utilisateur de démarrer ou de rejoindre 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.

Membre

Un utilisateur explicitement ajouté à un espace de réunion avec un rôle désigné (par exemple, COHOST). Contrairement à un participant qui n'est présent que pendant une conférence en direct, un membre est associé à l'espace de réunion permanent et conserve ses droits d'accès pour plusieurs conférences dans cet espace.

Participant

Personne participant à un appel ou utilisant le mode Compagnon, regardant en tant que spectateur ou appareil de salle connecté à un appel. Il existe une ressource participants pour 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 participantSessions 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.

Enregistrement

Fichier vidéo MP4 et métadonnées associées générés lorsqu'une conférence est enregistrée. Les enregistrements sont stockés dans le Drive de l'organisateur de la réunion et peuvent être récupérés en tant qu'artefacts de la réunion.

Adresse SIP

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

Note intelligente

Résumé concis des points clés et des tâches à effectuer d'une conférence généré par Gemini et exporté vers le Drive de l'organisateur de la réunion en tant que fichier Docs.

Transcription

Document texte reprenant la conversation d'une conférence, exporté vers le Drive de l'organisateur de la réunion au format Docs.

Saisie de la transcription

Segment distinct de la transcription vocale d'un participant à une conférence. Chaque entrée inclut l'identité du participant, l'heure, le texte prononcé et le code de langue. Elle est disponible pendant 30 jours après la fin de la conférence.