Cette page décrit les événements Google Meet auxquels votre application peut s'abonner à l'aide de l'API Google Workspace Events. Après avoir choisi types d'événements dont vous avez besoin, créez un abonnement pour commencer à recevoir depuis Google Meet.
Pour en savoir plus sur le développement d'applications pour Google Meet, consultez l'API REST Google Meet. présentation.
Événements Meet compatibles
Les abonnements Google Workspace vous permettent de recevoir des événements concernant les types de modifications suivants dans Meet:
- A conférence commence ou se termine dans un espace de réunion.
- A participant rejoint ou quitte une conférence.
- A enregistrement est généré pour une conférence.
- A transcription est généré pour une conférence.
Ressources pouvant être surveillées pour 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 est l'ID dans
nom de ressource de la ressource |
|
| Utilisateur | //cloudidentity.googleapis.com/users/USER
où USER est l'ID dans
|
L'abonnement reçoit les événements liés aux espaces de réunion où est l'une des valeurs suivantes:
|
Types d'événements liés à la création d'abonnements
Lorsque vous créez un abonnement à une ressource Meet, vous utilisez le
eventTypes[]
pour spécifier les types d'événements que vous souhaitez recevoir. Les types d'événements sont les suivants :
formatés conformément à la spécification CloudEvents, tels que
google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
Par exemple, pour recevoir des événements concernant les nouveaux participants à une conférence pour une
Espace Meet, vous spécifiez le type d'événement
google.workspace.meet.participant.v2.joined Pour en savoir plus sur la façon dont les événements
travail, consultez la page Structure de
événements.
Le tableau suivant affiche les types d'événements compatibles, une description et les 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. |
|
|
La conférence se termine dans l'espace de réunion. |
|
|
Un participant rejoint une conférence en cours dans l'espace de réunion. |
|
|
Un participant quitte une conférence en cours 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 les exemples de charge utile pour les événements dans Espaces de réunion Meet.
Lorsque votre abonnement Google Workspace reçoit un événement de
Meet, le
data
contient la charge utile pour l'événement. Cette charge utile contient des informations
ressource Google Workspace qui a été modifiée. Par exemple, si vous êtes abonné à
concernant les nouvelles transcriptions dans un espace, la charge utile de ces événements contient
des informations sur le
transcript
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 la méthode
conferenceRecords/AAA-BBB-CCC-DDD-EEE qui a lieu dans l'espace. Pour chaque événement
reçu par l'abonnement, la charge utile apparaît dans le champ data du
événement:
| Exemple | Event type (Type d'événement) | Charge utile JSON |
|---|---|---|
Une conférence commence dans l'espace de réunion Meet. |
|
Exclut 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. |
|
Exclut 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 |
Exclut 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 |
Exclut les données de ressources
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|