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 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 à des événements, vous pouvez également interroger des événements 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 pour rattraper les événements que vous avez peut-être manqués 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 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 que vous pouvez surveiller pour 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 :

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

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

où USER est l'ID dans le signedinUser.user champ 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 règle générale, le propriétaire de l'espace de réunion est également le 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, utilisez le eventTypes[] champ pour spécifier les types d'événements que vous souhaitez recevoir. Les types d'événements sont mis en forme conformément à la 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, spécifiez le type d'événement comme google.workspace.meet.participant.v2.joined. Pour en savoir plus sur le fonctionnement des événements work, consultez Structure des événements Google Workspace events.

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

Type d'événement Format Données de ressource
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 conférence active dans l'espace de réunion. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Un participant quitte une confé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 note intelligente démarre pour une conférence dans l'espace de réunion. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Une note intelligente se termine pour une conférence dans l'espace de réunion. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Un fichier de notes intelligentes est généré pour une conférence dans l'espace de réunion. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
Une transcription démarre pour une conférence dans l'espace de réunion. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Une transcription se termine pour une conférence dans l'espace de réunion. 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 des 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 data champ 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 de nouvelles transcriptions dans un espace, la charge utile de ces événements contient des informations sur la transcripts ressource qui a été modifiée.

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

Types d'événements Charge utile JSON

Une conférence commence ou se termine pour l'espace de réunion Meet space.

  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Exclut les données de ressource :

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

Un participant rejoint ou quitte une confé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 ressource :

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

Un enregistrement démarre, 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 ressource :

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

Une note intelligente démarre, se termine ou un fichier est généré pour une conférence dans l'espace de réunion Meet.

  • google.workspace.meet.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

Exclut les données de ressource :

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

Une transcription démarre, 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 ressource :

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

Limites
  • Les invités à un événement d'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.