In questa pagina vengono descritti gli eventi Google Meet a cui la tua app può abbonarsi utilizzando l'API Google Workspace Eventi. Dopo aver deciso i tipi di eventi di cui hai bisogno, crea un abbonamento per iniziare a ricevere eventi da Google Meet.
Per scoprire di più sullo sviluppo di app per Google Meet, consulta la panoramica sull'API REST di Google Meet.
Risorse di destinazione di Meet supportate
Per ricevere eventi Meet, l'API Google Workspace Eventi supporta gli abbonamenti alle seguenti risorse:
- Spazi per le riunioni, rappresentati come risorse di
space
. - Utenti, rappresentati come risorse
user
dell'API Cloud Identity.
Eventi di Meet supportati
Gli abbonamenti a Google Workspace ti consentono di ricevere in Meet eventi relativi ai seguenti tipi di modifiche:
- Una conferenza inizia o termina in uno spazio per le riunioni.
- Un partecipante partecipa a una conferenza o la abbandona.
- Per una conferenza viene generata una registrazione.
- Per una conferenza viene generata una trascrizione.
Quando crei un abbonamento a una risorsa Meet, utilizzi il campo eventTypes[]
per specificare quali tipi di eventi vuoi ricevere. I tipi di eventi sono formattati in base alla specifica CloudEvents, ad esempio google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
.
Ad esempio, per ricevere eventi relativi ai nuovi partecipanti a una conferenza per uno spazio di Meet, specifichi il tipo di evento come google.workspace.meet.participant.v2.joined
. Per scoprire di più su come funzionano gli eventi, consulta Struttura degli eventi di Google Workspace.
La tabella seguente mostra i tipi di eventi supportati, una descrizione e la risorsa di Meet modificata rappresentata nei dati sugli eventi:
Tipo di evento | Descrizione | Risorsa di Meet |
---|---|---|
|
La conferenza inizia nello spazio per le riunioni. |
|
|
Una conferenza termina nello spazio per le riunioni. |
|
|
Un partecipante partecipa a una conferenza attiva nello spazio delle riunioni. |
|
|
Un partecipante abbandona una conferenza attiva nello spazio delle riunioni. |
|
|
Viene generato un file di registrazione per una conferenza nello spazio delle riunioni. |
|
|
Viene generato un file di trascrizione per una conferenza nello spazio delle riunioni. |
|
Dati sugli eventi
Questa sezione descrive i dati sugli eventi e i payload di esempio per gli eventi negli spazi per le riunioni di Meet.
Quando il tuo abbonamento a Google Workspace riceve un evento da Meet, il campo data
contiene il payload per l'evento. Questo payload contiene informazioni sulla risorsa Google Workspace che è stata modificata. Ad esempio, se hai effettuato la sottoscrizione agli eventi relativi alle nuove trascrizioni in uno spazio, il payload per questi eventi contiene informazioni sulla risorsa transcript
che è stata modificata.
Dati delle risorse nel payload dell'evento
La tabella seguente fornisce esempi di payload JSON per un abbonamento a uno spazio per le riunioni di Meet. Negli esempi viene utilizzata la conferenza
conferenceRecords/AAA-BBB-CCC-DDD-EEE
che si svolge nello spazio. Per ogni evento ricevuto dalla sottoscrizione, il payload viene visualizzato nel campo data
dell'evento:
Esempio | Tipo di evento | Payload JSON |
---|---|---|
Viene avviata una conferenza per lo spazio per le riunioni di Meet. |
|
Esclude i dati delle risorse
{ "conferenceRecord": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE" } } |
Un partecipante partecipa a una conferenza nello spazio per le riunioni di Meet. |
|
Esclude i dati delle risorse
{ "participantSession": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP" } } |
Viene generata una registrazione per una conferenza nello spazio per le riunioni di Meet. | google.workspace.meet.recording.v2.fileGenerated |
Esclude i dati delle risorse
{ "recording": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP" } } |
Viene generata una trascrizione per una conferenza nello spazio per le riunioni di Meet. | google.workspace.meet.transcript.v2.fileGenerated |
Esclude i dati delle risorse
{ "transcript": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT" } } |