Rispondere agli eventi da Google Meet

Questo documento spiega come ricevere e rispondere agli eventi di Google Meet da Google Cloud Pub/Sub.

Un evento di Meet rappresenta un'attività o una modifica a una risorsa di Meet, ad esempio la creazione di una nuova riunione. Puoi utilizzare gli eventi per capire cosa è successo e poi intraprendere un'azione o rispondere in modo significativo per i tuoi utenti.

Ecco alcuni esempi di come puoi utilizzare gli eventi:

  • Osserva e rispondi alle modifiche in una riunione, ad esempio quando una riunione inizia o termina.

  • Tieni traccia di chi ha partecipato alla riunione per scopi normativi o di formazione.

  • Ascolta la trascrizione della riunione in modo che i contenuti del file possano essere analizzati e registrati in un CRM o in un database.

Come funzionano gli eventi

Ogni volta che succede qualcosa in Google Meet, viene creata o aggiornata una risorsa dell'API REST di Google Meet. Meet utilizza gli eventi per fornire alla tua app informazioni sul tipo di attività che si è verificata e sulla risorsa dell'API REST di Meet interessata.

Esempio di come un nuovo spazio per riunioni attiva un evento.
Figura 1. Un utente crea uno spazio riunioni, che crea una Space risorsa. Meet crea quindi un evento che contiene dati sul nuovo spazio riunioni.

Meet classifica gli eventi per tipo. I tipi di eventi ti aiutano a filtrare e ricevere solo il tipo di informazioni di cui hai bisogno e ti consentono di gestire le attività simili nello stesso modo.

L'esempio seguente mostra in che modo un'attività in Meet influisce su una risorsa dell'API REST di Meet correlata e sul tipo di evento che riceve la tua app Meet:

Attività Risorsa dell'API REST di Meet Tipo di evento
Un utente partecipa a uno spazio riunioni. Viene creata una risorsa ConferenceRecord. Nuovo record della conferenza

Ricevere dati sugli eventi da Google Meet

Per ricevere i dati sugli eventi, la tua app può eseguire una delle seguenti operazioni:

La tabella seguente spiega la differenza e i motivi per cui è consigliabile iscriversi agli eventi anziché eseguire query:

Iscriviti agli eventi Esegui query sui dati
Casi d'uso
  • Elabora o rispondi agli eventi in tempo reale.
  • Monitora le modifiche alle risorse per migliorare le prestazioni della tua app.
  • Recupera i dati manualmente.
  • Recupera tutti i dati da Meet (a causa di un'interruzione o di un abbonamento inattivo).
API API Google Workspace Events API REST di Meet
Origine degli eventi Record della conferenza e utenti Spazio e record della conferenza
Eventi supportati Record della conferenza

Per un elenco dei tipi di eventi supportati, consulta Tipi di eventi per la creazione di abbonamenti nella documentazione dell'API Google Workspace Events. 		Spazio e record della conferenza

Per un elenco degli endpoint supportati, consulta la Space risorsa e la ConferenceRecord risorsa nella documentazione dell'API REST di Meet.
Formato degli eventi Un messaggio di Google Cloud Pub/Sub, formattato in base alla specifica CloudEvent specifica. Per maggiori dettagli, vedi Struttura degli eventi di Google Workspace. Una risorsa dell'API REST di Meet (Space e ConferenceRecord)
Dati sugli eventi Stringa con codifica base64 con o senza dati delle risorse. Per i payload di esempio, vedi Dati sugli eventi. Payload JSON contenente i dati delle risorse. Per un payload di esempio, vedi la ConferenceRecord risorsa nella documentazione di riferimento.

Esempio: recuperare gli eventi relativi ai partecipanti in uno spazio riunioni

In questo esempio, un'app Meet vuole ricevere informazioni sulle modifiche dei partecipanti in uno spazio riunioni. Nello spazio riunioni, un partecipante partecipa a una conferenza attiva, che popola una ParticipantSession risorsa e attiva un nuovo evento. Puoi quindi ottenere informazioni su questi eventi utilizzando il metodo di iscrizione o di query.

Iscriviti agli eventi

Per ricevere gli eventi in tempo reale, l'app Meet chiama il metodo subscriptions.create dell'API Google Workspace Events per iscriversi allo spazio riunioni per tutti i tipi di eventi. Dopo aver creato l'abbonamento, l'app Meet può iniziare a ricevere gli eventi.

Un'app Meet che si iscrive agli eventi dei partecipanti utilizzando l'API Google Workspace Events.
Figura 2. Un'app Meet riceve gli eventi dei partecipanti tramite un abbonamento utilizzando l' API Google Workspace Events.

Nella Figura 2, l'app Meet ha un abbonamento attivo allo spazio riunioni, quindi l'app riceve un evento ogni volta che una sessione dei partecipanti cambia nello spazio riunioni. L'app Meet può quindi rispondere in tempo reale a una qualsiasi delle attività, ad esempio sapere quando un partecipante partecipa o abbandona una conferenza attiva.

Per scoprire come creare abbonamenti utilizzando l'API Google Workspace Events, consulta la documentazione dell'API Google Workspace Events.

Esegui query sugli eventi recenti

Anziché ricevere gli eventi man mano che si verificano, un'app Meet può anche chiamare l'API REST di Meet per elencare gli eventi recenti dello spazio riunioni correlati all'attività dei partecipanti.

Un'app Meet che esegue query sugli eventi dei partecipanti utilizzando l'API REST di Meet.
Figura 3. Un'app Meet riceve gli eventi recenti dei partecipanti eseguendo una query sugli eventi dello spazio riunioni utilizzando l' API REST di Meet.

Nella Figura 3, un'app Meet chiama il metodo dell'API REST di Meet conferenceRecords.participants.participantSessions.list dopo che si sono verificate tutte le attività della sessione dei partecipanti. L'API REST di Meet restituisce un elenco di risorse ParticipantSession che rappresentano ciascuna delle modifiche. L'app Meet può quindi elaborare o rispondere in base all'attività recente, ad esempio creando un elenco dei partecipanti che hanno partecipato e abbandonato la conferenza.

Per eseguire query sugli eventi utilizzando l'API REST di Meet, vedi Elencare tutte le sessioni dei partecipanti.

Limitazioni
  • Gli invitati di Calendar e gli altri partecipanti invitati a una conferenza possono ricevere solo i seguenti eventi: google.workspace.meet.conference.v2.started e google.workspace.meet.transcript.v2.fileGenerated.