Répondre aux événements depuis Google Meet

Ce document explique comment recevoir des événements Google Meet et y répondre à partir de Google Cloud Pub/Sub.

Un événement Meet représente une activité ou une modification apportée à une ressource Meet, comme la création d'une réunion. Vous pouvez utiliser les événements pour comprendre ce qui s'est passé, puis prendre des mesures ou répondre de manière pertinente à vos utilisateurs.

Voici quelques exemples d'utilisation des événements :

  • Observer et répondre aux changements dans une réunion, par exemple lorsqu'elle commence ou se termine.

  • Suivez la participation à la réunion à des fins réglementaires ou de formation.

  • Écoutez la transcription de la réunion pour que le contenu du fichier puisse être analysé et consigné dans un CRM ou une base de données.

Fonctionnement des événements

Chaque fois qu'un événement se produit dans Google Meet, une ressource de l'API REST Google Meet est créée ou mise à jour. Meet utilise des événements pour fournir à votre application des informations sur le type d'activité qui s'est produit et sur la ressource de l'API REST Meet qui a été affectée.

Exemple de la façon dont un nouvel espace de réunion déclenche un événement.
Figure 1 : Un utilisateur crée un espace de réunion, ce qui crée une ressource Space. Meet crée ensuite un événement contenant des données sur le nouvel espace de réunion.

Meet classe les événements par type. Les types d'événements vous aident à filtrer et à ne recevoir que le type d'informations dont vous avez besoin, et vous permettent de gérer les activités similaires de la même manière.

L'exemple suivant montre comment une activité dans Meet affecte une ressource Meet REST API associée, ainsi que le type d'événement que votre application Meet reçoit :

Activité Ressource de l'API REST Meet Type d'événement
Un utilisateur rejoint un espace de réunion. Une ressource ConferenceRecord est créée. Nouvel enregistrement de conférence

Recevoir des données d'événement de Google Meet

Pour recevoir des données d'événement, votre application peut effectuer l'une des opérations suivantes :

Le tableau suivant explique la différence entre s'abonner à des événements et les interroger, et les raisons de s'abonner :

S'abonner à des événements Interroger les données
Cas d'utilisation
  • traiter les événements ou y répondre en temps réel ;
  • Surveillez les modifications apportées aux ressources pour améliorer les performances de votre application.
  • Récupérez les données manuellement.
  • Récupérer toutes les données Meet (en raison d'une panne ou d'un abonnement inactif)
API API Google Workspace Events Meet API REST
Source des événements Record de la conférence et utilisateurs Espace et enregistrement de conférence
Événements compatibles Enregistrement de la conférence

Pour obtenir la liste des types d'événements acceptés, consultez Types d'événements pour la création d'abonnements dans la documentation de l'API Google Workspace Events. 		Espace et enregistrement de réunion

Pour obtenir la liste des points de terminaison compatibles, consultez la ressource Space et la ressource ConferenceRecord dans la documentation de l'API Meet REST.
Format des événements Message Google Cloud Pub/Sub, mis en forme selon la spécification CloudEvent. Pour en savoir plus, consultez Structure des événements Google Workspace. Ressource de l'API REST Meet (Space et ConferenceRecord)
Données d'événement Chaîne encodée en base64 avec ou sans données de ressources. Pour obtenir des exemples de charges utiles, consultez Données d'événement. Charge utile JSON contenant les données de ressources. Pour obtenir un exemple de charge utile, consultez la ressource ConferenceRecord dans la documentation de référence.

Exemple : Récupérer des événements concernant les participants à un espace de réunion

Dans cet exemple, une application Meet souhaite recevoir des informations sur les modifications apportées aux participants dans un espace de réunion. Dans l'espace de réunion, un participant rejoint une visioconférence active, ce qui remplit une ressource ParticipantSession et déclenche un nouvel événement. Vous pouvez ensuite obtenir des informations sur ces événements à l'aide des méthodes subscribe ou query.

S'abonner à des événements

Pour recevoir des événements en temps réel, l'application Meet appelle la méthode subscriptions.create de l'API Google Workspace Events pour s'abonner à l'espace de réunion pour tous les types d'événements. Une fois l'abonnement créé, l'application Meet peut commencer à recevoir des événements.

Une application Meet qui s'abonne aux événements liés aux participants à l'aide de l'API Google Workspace Events.
Figure 2. Une application Meet reçoit les événements liés aux participants via un abonnement à l'aide de l'API Google Workspace Events.

Dans la figure 2, l'application Meet dispose d'un abonnement actif à l'espace de réunion. Elle reçoit donc un événement chaque fois qu'une session de participant change dans l'espace de réunion. L'application Meet peut alors répondre en temps réel à toutes les activités, par exemple en sachant quand un participant rejoint ou quitte une conférence active.

Pour savoir comment créer des abonnements à l'aide de l'API Google Workspace Events, consultez la documentation de l'API Google Workspace Events.

Interroger les événements récents

Au lieu de recevoir des événements au fur et à mesure qu'ils se produisent, une application Meet peut également appeler l'API Meet REST pour lister les événements récents de l'espace de réunion liés à l'activité des participants.

Une application Meet qui interroge les événements des participants à l'aide de l'API REST Meet.
Figure 3. Une application Meet reçoit les événements de participants récents en interrogeant les événements d'espace de réunion à l'aide de l'API REST Meet.

Dans la figure 3, une application Meet appelle la méthode conferenceRecords.participants.participantSessions.list de l'API Meet REST une fois que toutes les activités de session des participants ont eu lieu. L'API REST Meet renvoie une liste de ressources ParticipantSession qui représentent chacune des modifications. L'application Meet peut ensuite traiter ou répondre en fonction de l'activité récente, par exemple en créant une liste des participants qui ont rejoint et quitté la conférence.

Pour interroger des événements à l'aide de l'API REST Meet, consultez Lister toutes les sessions des participants.

Limites
  • Les invités à un événement Agenda et les autres participants invités à une visioconférence ne peuvent recevoir que les événements suivants : google.workspace.meet.conference.v2.started et google.workspace.meet.transcript.v2.fileGenerated.