S'abonner à des événements Google Meet

Cette page décrit les événements Google 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 depuis Google Meet.

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

Ressources cibles Meet compatibles

Pour recevoir des événements Meet, l'API Google Workspace Events accepte les abonnements aux ressources suivantes:

• Espaces de réunion, représentés par des ressources space
• Utilisateurs, représentés par des ressources user de l'API Cloud Identity.

É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 est généré pour une conférence.
• Une transcription est générée pour une conférence.

Lorsque vous créez un abonnement à une ressource Meet, vous utilisez le champ eventTypes[] pour spécifier les types d'événements que vous souhaitez recevoir. Les types d'événements sont mis en forme conformément à la spécification CloudEvents, par exemple google.workspace.APPLICATION.RESOURCE.VERSION.ACTION. Par exemple, pour recevoir des événements sur les nouveaux participants à une conférence dans un espace Meet, vous devez spécifier 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 présente les types d'événements compatibles, une description et la ressource Meet modifiée représentée dans les données d'événement:

Données d'événement

Cette section décrit les données d'événement et des exemples de charges utiles pour les événements se déroulant 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é à des événements concernant les nouvelles transcriptions dans un espace, la charge utile de ces événements contient des informations sur la ressource transcript qui a été modifiée.

Données de ressources 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 la conférence conferenceRecords/AAA-BBB-CCC-DDD-EEE qui a lieu dans l'espace. 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/AAA-BBB-CCC-DDD-EEE"
    }
}
      

{
    "participantSession":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
    }
}
      

{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
      

{
    "transcript":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}
      

Articles associés

• Tutoriel: Observer les événements de réunion avec Python et l'API REST Google Meet
• Structure des événements Google Workspace
• Choisir les champs d'application OAuth
• Créez un abonnement pour recevoir des événements Meet.
• Présentation de l'API REST de Google Meet