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 Meet rappresenta un'attività o una modifica a una risorsa Meet, ad esempio la creazione di una nuova riunione. Puoi utilizzare gli eventi per capire cosa è successo e poi intervenire o per rispondere in modo significativo per i tuoi utenti.

Ecco alcuni esempi di come puoi utilizzare gli eventi:

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

  • Monitorare 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 informazioni alla tua app sul tipo di attività che si è verificata e sulla risorsa dell'API REST di Meet interessata.

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

Meet classifica gli eventi in base al 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 attività simili nello stesso modo.

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

Attività Risorsa API REST di Meet Tipo di evento
Un utente partecipa a uno spazio per le riunioni. Viene creata una risorsa ConferenceRecord. Nuovo record in lega

Ricevere dati sugli eventi da Google Meet

Per ricevere i dati sugli eventi, la tua app può procedere in uno dei seguenti modi:

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

Iscriviti agli eventi Eseguire query per i dati
Casi d'uso
  • Elabora o rispondi agli eventi in tempo reale.
  • Monitora le modifiche alle risorse per migliorare il rendimento della tua app.
  • Recupera i dati manualmente.
  • Recuperare 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 di conference e utenti Spazio e record in lega
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 registrazione della conferenza

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

Esempio: recuperare eventi relativi ai partecipanti in uno spazio riunioni

In questo esempio, un'app Meet vuole ricevere informazioni sulle modifiche ai partecipanti in uno spazio per le riunioni. Nello spazio della riunione, un partecipante si unisce a una conferenza attiva, che compila una risorsa ParticipantSession e attiva un nuovo evento. Puoi quindi ottenere informazioni su questi eventi utilizzando il metodo subscribe o 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 eventi.

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

Nella figura 2, l'app Meet ha un abbonamento attivo allo spazio per le riunioni, quindi riceve un evento ogni volta che una sessione di un partecipante cambia nello spazio per le riunioni. L'app Meet può quindi rispondere in tempo reale a qualsiasi attività, ad esempio sapere quando un partecipante entra o esce da una conferenza attiva.

Per informazioni sulla creazione di abbonamenti utilizzando l'API Google Workspace Events, consulta la documentazione dell'API Google Workspace Events.

Query per gli 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 query sugli eventi dello spazio di riunione 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, consulta Elenca 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.