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.

Meet classe les événements par type. Les types d'événements vous aident à filtrer les informations et à ne recevoir que celles dont vous avez besoin. Ils vous permettent également 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.

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.