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 déterminé les types d'événements dont vous avez besoin, créez un abonnement pour commencer à recevoir des événements de Meet.

Pour en savoir plus sur le développement d'applications pour Meet, consultez la présentation de l'API REST Google 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 est généré pour une conférence.
• Une transcription est générée pour une conférence.

Ressources pour lesquelles vous pouvez surveiller les événements

Pour recevoir des événements, vous devez spécifier 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, 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 concernant les nouveaux participants à une conférence dans un espace Meet, vous spécifiez le type d'événement comme 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 affiche les types d'événements acceptés, une description et la ressource Meet modifiée représentée dans les données de l'événement :

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. Ce payload 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 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 l'ID d'enregistrement de la conférence (par exemple, conferenceRecords/AAA-BBB-CCC-DDD-EEE) 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 s'affiche 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"
    }
}
      

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

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 habilitations de l'API REST Google Meet
• Tutoriel : Observer les événements de réunion avec Python et l'API REST Google Meet