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 :

  • 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 ou se termine, ou un fichier est généré pour une conférence.
  • Une transcription démarre ou se termine, ou un fichier est généré 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 :

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 de ressources
Une conférence commence dans l'espace de réunion. google.workspace.meet.conference.v2.started conferenceRecord
Une conférence se termine dans l'espace de réunion. google.workspace.meet.conference.v2.ended conferenceRecord
Un participant rejoint une visioconférence active dans l'espace de réunion. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Un participant quitte une visioconférence active dans l'espace de réunion. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Un enregistrement démarre pour une conférence dans l'espace de réunion. google.workspace.meet.recording.v2.started conferenceRecord.recording
Un enregistrement se termine pour une conférence dans l'espace de réunion. google.workspace.meet.recording.v2.ended conferenceRecord.recording
Un fichier d'enregistrement est généré pour une conférence dans l'espace de réunion. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Une transcription démarre pour une conférence dans l'espace de réunion. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
La transcription d'une conférence dans l'espace de réunion se termine. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
Un fichier de transcription est généré pour une conférence dans l'espace de réunion. google.workspace.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 visioconférence démarre ou se termine pour l'espace de réunion Meet.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Exclut les données de ressources :

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Un participant rejoint ou quitte une visioconférence dans l'espace de réunion Meet.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Exclut les données de ressources :

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
Un enregistrement démarre ou se termine, ou un fichier est généré pour une conférence dans l'espace de réunion Meet.
  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

Exclut les données de ressources :

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Une transcription démarre ou se termine, ou un fichier est généré pour une conférence dans l'espace de réunion Meet.
  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • google.workspace.meet.transcript.v2.fileGenerated

Exclut les données de 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.