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 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.
Événements Meet compatibles
Les abonnements Google Workspace vous permettent de recevoir des événements pour 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 que vous pouvez surveiller pour détecter des é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 est l'ID dans le
nom de la ressource de la ressource |
|
| Utilisateur | //cloudidentity.googleapis.com/users/USER
où USER est l'ID dans le champ
|
L'abonnement reçoit des événements sur les espaces de réunion pour lesquels l'utilisateur est l'un des éléments suivants:
|
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 sur les nouveaux participants à une conférence pour 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 la section 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:
| Event type (Type d'événement) | Description | Ressource Meet |
|---|---|---|
|
Une conférence commence dans l'espace de réunion. |
|
|
Une conférence se termine dans l'espace de réunion. |
|
|
Un participant rejoint une conférence active dans l'espace de réunion. |
|
|
Un participant quitte une conférence active dans l'espace de réunion. |
|
|
Un fichier d'enregistrement est généré pour une conférence dans l'espace de réunion. |
|
|
Un fichier de transcription est généré pour une conférence dans l'espace de réunion. |
|
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 champ data contient la charge utile de l'événement. Cette charge utile contient des informations sur la ressource Google Workspace 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 ressource transcript qui a changé.
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 se déroule 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:
| Exemple | Event type (Type d'événement) | Charge utile JSON |
|---|---|---|
Une conférence commence pour l'espace de réunion Meet. |
|
Excluit les données de ressources
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| Un participant rejoint une conférence dans l'espace de réunion Meet. |
|
Excluit les données de ressources
{
"participantSession":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
}
}
|
| Un enregistrement est généré pour une conférence dans l'espace de réunion Meet. | google.workspace.meet.recording.v2.fileGenerated |
Excluit les données de ressources
{
"recording":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
}
}
|
| Une transcription est générée pour une conférence dans l'espace de réunion Meet. | google.workspace.meet.transcript.v2.fileGenerated |
Excluit les données de ressources
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|