In questa pagina vengono descritti gli eventi di Google Meet a cui la tua app può abbonarsi utilizzando l'API Google Workspace Events. Dopo aver deciso 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 pagina sull'API REST Google Meet. Panoramica.
Eventi di Meet supportati
Gli abbonamenti a Google Workspace ti consentono di ricevere eventi relativi a i seguenti tipi di modifiche in Meet:
- R conferenza inizia o termina in uno spazio per le riunioni.
- R partecipante partecipa a una conferenza o la abbandona.
- R per 5 giorni viene generato per una conferenza.
- R trascrizione viene generato per una conferenza.
Risorse che puoi monitorare per gli eventi
Per ricevere eventi, devi specificare una risorsa Meet da monitorare, denominata risorsa di destinazione della sottoscrizione.
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 nella
nome risorsa della risorsa |
|
Utente | //cloudidentity.googleapis.com/users/USER
dove USER è l'ID nella
Campo |
L'abbonamento riceve gli eventi relativi agli spazi per riunioni in cui L'utente può essere uno dei seguenti:
|
Tipi di eventi per la creazione di sottoscrizioni
Quando crei un abbonamento a una risorsa di Meet, utilizzi il
eventTypes[]
per specificare quali tipi di eventi vuoi ricevere. I tipi di evento sono
formattati in base alla specifica CloudEvents, come
google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
.
Ad esempio, per ricevere eventi relativi a nuovi partecipanti a una conferenza per
Meet, puoi specificare il tipo di evento
google.workspace.meet.participant.v2.joined
. Per scoprire di più su come gli eventi
consulta Struttura di Google Workspace
eventi.
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 per le riunioni. |
|
|
La conferenza termina nello spazio per le riunioni. |
|
|
Un partecipante partecipa a una conferenza attiva nello spazio della riunione. |
|
|
Un partecipante abbandona una conferenza attiva nello spazio della riunione. |
|
|
Viene generato un file di registrazione per una conferenza nello spazio della riunione. |
|
|
Viene generato un file di trascrizione per una conferenza nello spazio della riunione. |
|
Dati sugli eventi
Questa sezione descrive i dati sugli eventi e i payload di esempio per gli eventi in Spazi per le riunioni di Meet.
Quando il tuo abbonamento a Google Workspace riceve un evento da
Meet, il
data
contiene il payload per l’evento. Questo payload contiene informazioni
Risorsa Google Workspace modificata. Ad esempio, se hai sottoscritto un abbonamento a
eventi su nuove trascrizioni in uno spazio, il payload per questi eventi
informazioni sui
transcript
risorsa che è stata modificata.
Dati delle risorse nel payload dell'evento
La tabella seguente fornisce esempi di payload JSON per una sottoscrizione a
uno spazio per riunioni di Meet. Gli esempi utilizzano 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
della
dell'evento:
Esempio | Tipo di evento | Payload JSON |
---|---|---|
Viene avviata una conferenza per lo spazio delle riunioni di Meet. |
|
Esclude i dati delle risorse
{ "conferenceRecord": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE" } } |
Un partecipante partecipa a una conferenza nello spazio delle 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 delle 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 delle 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" } } |