Iscriviti agli eventi di Google Meet

In questa pagina vengono descritti gli eventi Google Meet a cui la tua app può abbonarsi utilizzando l'API Google Workspace Eventi. Dopo aver deciso i 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 panoramica sull'API REST di Google Meet.

Risorse di destinazione di Meet supportate

Per ricevere eventi Meet, l'API Google Workspace Eventi supporta gli abbonamenti alle seguenti risorse:

  • Spazi per le riunioni, rappresentati come risorse di space.
  • Utenti, rappresentati come risorse user dell'API Cloud Identity.

Eventi di Meet supportati

Gli abbonamenti a Google Workspace ti consentono di ricevere in Meet eventi relativi ai seguenti tipi di modifiche:

Quando crei un abbonamento a una risorsa Meet, utilizzi il campo eventTypes[] per specificare quali tipi di eventi vuoi ricevere. I tipi di eventi sono formattati in base alla specifica CloudEvents, ad esempio google.workspace.APPLICATION.RESOURCE.VERSION.ACTION. Ad esempio, per ricevere eventi relativi ai nuovi partecipanti a una conferenza per uno spazio di Meet, specifichi il tipo di evento come google.workspace.meet.participant.v2.joined. Per scoprire di più su come funzionano gli eventi, consulta Struttura degli eventi di Google Workspace.

La tabella seguente mostra i tipi di eventi supportati, una descrizione e la risorsa di Meet modificata rappresentata nei dati sugli eventi:

Tipo di evento Descrizione Risorsa di Meet

google.workspace.meet.conference.v2.started

La conferenza inizia nello spazio per le riunioni.

conferenceRecord

google.workspace.meet.conference.v2.ended

Una conferenza termina nello spazio per le riunioni.

conferenceRecord

google.workspace.meet.participant.v2.joined

Un partecipante partecipa a una conferenza attiva nello spazio delle riunioni.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Un partecipante abbandona una conferenza attiva nello spazio delle riunioni.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

Viene generato un file di registrazione per una conferenza nello spazio delle riunioni.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Viene generato un file di trascrizione per una conferenza nello spazio delle riunioni.

conferenceRecord.transcript

Dati sugli eventi

Questa sezione descrive i dati sugli eventi e i payload di esempio per gli eventi negli spazi per le riunioni di Meet.

Quando il tuo 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 che è stata modificata. Ad esempio, se hai effettuato la sottoscrizione agli eventi relativi alle nuove trascrizioni in uno spazio, il payload per questi eventi contiene informazioni sulla risorsa transcript che è stata modificata.

Dati delle risorse nel payload dell'evento

La tabella seguente fornisce esempi di payload JSON per un abbonamento a uno spazio per le riunioni di Meet. Negli esempi viene utilizzata 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 dell'evento:

Esempio Tipo di evento Payload JSON

Viene avviata una conferenza per lo spazio per le riunioni di Meet.

google.workspace.meet.conference.v2.started

Esclude i dati delle risorse
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
Un partecipante partecipa a una conferenza nello spazio per le riunioni di Meet.

google.workspace.meet.participant.v2.joined

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 per le 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 per le 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"
    }
}