S'abonner à des événements Google Meet

Ce document décrit les événements Meet auxquels votre application peut s'abonner à l'aide de l'API Google Workspace Events. Une fois que vous avez choisi les types d'événements dont vous avez besoin, créez un abonnement pour commencer à recevoir des événements de Meet.

En plus de vous abonner à des événements, vous pouvez également les interroger en appelant l'API REST Google Meet. Appelez l'API REST Meet pour récupérer régulièrement des événements ou rattraper ceux que vous avez peut-être manqués d'un abonnement en raison d'une panne. Pour découvrir comment recevoir des événements Meet et y répondre, consultez Répondre aux événements de Google Meet dans la documentation Meet.

Pour en savoir plus sur le développement d'applications pour Meet, consultez la présentation de l'API REST Meet.

Événements Meet compatibles

Les abonnements Google Workspace vous permettent de recevoir des événements concernant les types de modifications suivants dans Meet :

• Une conférence commence ou se termine dans un espace de réunion.
• Un participant rejoint ou quitte une conférence.
• Un enregistrement démarre, se termine ou un fichier est généré pour une conférence.
• Une note intelligente démarre, se termine ou un fichier est généré pour une conférence.
• Une transcription démarre, se termine ou un fichier est généré pour une conférence.

Ressources dont vous pouvez surveiller les événements

Pour recevoir des événements, spécifiez une ressource Meet à surveiller, appelée ressource cible de l'abonnement.

L'API Google Workspace Events est compatible avec les ressources cibles suivantes pour Meet :

Types d'événements pour la création d'abonnements

Lorsque vous créez un abonnement à une ressource Meet, utilisez le champ eventTypes[] pour spécifier les types d'événements que vous souhaitez recevoir. Les types d'événements sont formatés conformément à la spécification CloudEvents, par exemple google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Par exemple, pour recevoir des événements concernant les nouveaux participants à une conférence pour un espace Meet, spécifiez le type d'événement google.workspace.meet.participant.v2.joined. Pour en savoir plus sur le fonctionnement des événements, consultez Structure des événements Google Workspace.

Le tableau suivant indique les types d'événements compatibles avec les abonnements aux ressources Meet :

Données d'événement

Cette section décrit les données d'événement et les exemples de charges utiles pour les événements dans les espaces de réunion Meet.

Lorsque votre abonnement Google Workspace reçoit un événement de Meet, le champ data contient la charge utile de l'événement. Cette charge utile contient des informations sur la ressource Google Workspace qui a été modifiée. Par exemple, si vous vous êtes abonné aux événements concernant les nouvelles transcriptions dans un espace, la charge utile de ces événements contient des informations sur la ressource transcripts qui a changé.

Données de ressource dans la charge utile de l'événement

Le tableau suivant fournit des exemples de charges utiles JSON pour un abonnement à un espace de réunion Meet. Les exemples utilisent l'ID d'enregistrement de la conférence (par exemple, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) pour identifier l'espace de réunion. Pour en savoir plus, consultez Comment Meet identifie un espace de réunion.

Pour chaque événement reçu par l'abonnement, la charge utile apparaît dans le champ data de l'événement :

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}
      

• Les participants à l'agenda et les autres participants invités à une conférence ne peuvent recevoir que les événements suivants : google.workspace.meet.conference.v2.started et google.workspace.meet.transcript.v2.fileGenerated.

Articles associés

• Présentation de l'API Google Workspace Events
• Structure des événements Google Workspace
• Choisir les habilitations de l'API Google Workspace Events
• Présentation de l'API REST Google Meet
• Choisir les champs d'application de l'API REST Meet
• Tutoriel : Observer les événements d'une réunion avec Python et l'API REST Google Meet