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.

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é eseguirne query:

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.

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.