S'abonner à des événements Google Meet

Ce document 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.

En plus de vous abonner aux événements, vous pouvez également les interroger en appelant l'API REST Google Meet. Appelez l'API REST Meet pour récupérer des événements de manière périodique ou rattraper les événements que vous avez peut-être manqués lors 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 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 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 :

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 :

Ressource cible Format Limites (le cas échéant)
Espace de réunion //meet.googleapis.com/spaces/SPACE

où SPACE correspond à l'ID dans le nom de ressource de la ressource spaces de l'API Meet REST. Pour en savoir plus, consultez Comment Meet identifie un espace de réunion.
Utilisateur //cloudidentity.googleapis.com/users/USER

où USER correspond à l'ID dans le champ signedinUser.user de la ressource participants de l'API REST Meet. Pour en savoir plus, consultez Utiliser des participants.

L'abonnement reçoit des événements concernant tous les espaces de réunion dont l'utilisateur est le propriétaire. En général, le propriétaire de l'espace de réunion est également l'organisateur de l'événement Google Agenda associé à l'espace de réunion.

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 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 acceptés pour les abonnements aux ressources Meet :

Type d'événement Format Données sur les ressources
Une conférence commence dans l'espace de réunion. google.meet.conference.v2.started conferenceRecord
Une conférence se termine dans l'espace de réunion. google.meet.conference.v2.ended conferenceRecord
Un participant rejoint une visioconférence active dans l'espace de réunion. google.meet.participant.v2.joined conferenceRecord.participantSession
Un participant quitte une visioconférence active dans l'espace de réunion. google.meet.participant.v2.left conferenceRecord.participantSession
Un fichier d'enregistrement est généré pour une conférence dans l'espace de réunion. google.meet.recording.v2.fileGenerated conferenceRecord.recording
Un fichier de transcription est généré pour une conférence dans l'espace de réunion. google.meet.transcript.v2.fileGenerated conferenceRecord.transcript

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 transcripts 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/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 s'affiche dans le champ data de l'événement :

Exemple Type d'événement Charge utile JSON

Une conférence démarre pour l'espace de réunion Meet.

google.workspace.meet.conference.v2.started
Exclut les données sur les ressources
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Un participant rejoint une visioconférence dans l'espace de réunion Meet.

google.workspace.meet.participant.v2.joined
Exclut les données sur les ressources
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
Un enregistrement est généré pour une conférence dans l'espace de réunion Meet. google.workspace.meet.recording.v2.fileGenerated
Exclut les données sur les ressources
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Une transcription est générée pour une conférence dans l'espace de réunion Meet. google.workspace.meet.transcript.v2.fileGenerated
Exclut les données sur les ressources
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

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.