Questa pagina descrive gli eventi di Google Meet a cui la tua app può iscriversi utilizzando l'API Google Workspace Events. Dopo aver deciso quali tipi di eventi ti servono, crea un abbonamento per iniziare a ricevere gli eventi da Google Meet.
Per scoprire di più sullo sviluppo di app per Google Meet, consulta la panoramica dell'API REST di Google Meet.
Eventi di Meet supportati
Gli abbonamenti a Google Workspace ti consentono di ricevere eventi relativi ai seguenti tipi di modifiche in Meet:
- Una conferenza inizia o termina in uno spazio di riunione.
- Un partecipante si unisce o lascia una conferenza.
- Viene generata una registrazione per una conferenza.
- Viene generata una trascrizione per una conferenza.
Risorse che puoi monitorare per rilevare eventi
Per ricevere gli eventi, specifica una risorsa Meet da monitorare, chiamata risorsa di destinazione dell'abbonamento.
L'API Google Workspace Events supporta le seguenti risorse di destinazione per Meet:
| Risorsa di destinazione | Formato | Limitazioni (se applicabili) |
|---|---|---|
| Spazio per le riunioni | //meet.googleapis.com/spaces/SPACE
dove SPACE è l'ID nel
nome della risorsa della risorsa |
|
| Utente | //cloudidentity.googleapis.com/users/USER
dove USER è l'ID nel
|
L'abbonamento riceve eventi relativi agli spazi di riunione in cui l'utente è uno dei seguenti:
|
Tipi di eventi per la creazione di iscrizioni
Quando crei una sottoscrizione a una risorsa Meet, utilizzi il campo
eventTypes[]
per specificare i tipi di eventi che vuoi ricevere. I tipi di evento sono formattati in base alla specifica CloudEvents, ad esempiogoogle.workspace.APPLICATION.RESOURCE.VERSION.ACTION.
Ad esempio, per ricevere eventi relativi ai nuovi partecipanti a una conferenza per uno spazio Meet, specifica il tipo di evento come google.workspace.meet.participant.v2.joined. Per scoprire di più su come funzionano gli eventi, consulta la sezione Struttura degli eventi di Google Workspace.
La tabella seguente mostra i tipi di eventi supportati, una descrizione e la risorsa Meet modificata rappresentata nei dati sugli eventi:
| Tipo di evento | Descrizione | Risorsa Meet |
|---|---|---|
|
Una conferenza inizia nello spazio di riunione. |
|
|
Una conferenza termina nello spazio per riunioni. |
|
|
Un partecipante si unisce a una conferenza attiva nello spazio di riunione. |
|
|
Un partecipante lascia una conferenza attiva nello spazio di riunione. |
|
|
Viene generato un file di registrazione per una conferenza nello spazio di riunione. |
|
|
Viene generato un file della trascrizione di una conferenza nello spazio di riunione. |
|
Dati sugli eventi
Questa sezione descrive i dati sugli eventi e i payload di esempio per gli eventi negli spazi di riunione di Meet.
Quando l'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 modificata. Ad esempio, se hai effettuato l'iscrizione agli eventi relativi alle nuove trascrizioni in uno spazio, il payload di questi eventi contiene informazioni sulla risorsa transcript modificata.
Dati della risorsa nel payload dell'evento
La seguente tabella fornisce esempi di payload JSON per un abbonamento a un meeting space di Meet. Gli esempi utilizzano la conferenzaconferenceRecords/AAA-BBB-CCC-DDD-EEE che si svolge nello spazio. Per ogni evento ricevuto dall'abbonamento, il payload viene visualizzato nel campo data dell'evento:
| Esempio | Tipo di evento | Payload JSON |
|---|---|---|
Viene avviata una conferenza per lo spazio di riunione di Meet. |
|
Sono esclusi i dati delle risorse
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| Un partecipante si unisce a una conferenza nello spazio di riunione di Meet. |
|
Sono esclusi 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 di riunione di Meet. | google.workspace.meet.recording.v2.fileGenerated |
Sono esclusi 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 di riunione di Meet. | google.workspace.meet.transcript.v2.fileGenerated |
Sono esclusi i dati delle risorse
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|