Iscriviti agli eventi di Google Meet

Questa pagina descrive gli eventi di Google Meet a cui la tua app può iscriversi utilizzando l'API Google Workspace Events. Dopo aver deciso di quali tipi di eventi hai bisogno, crea un abbonamento per iniziare a ricevere eventi da Meet.

Per scoprire di più sullo sviluppo di app per Meet, consulta la panoramica dell'API REST di Google Meet.

Eventi Meet supportati

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

• Una conferenza inizia o termina in uno spazio riunione.
• Un partecipante si unisce a una conferenza o la abbandona.
• Viene generata una registrazione per una conferenza.
• Per una conferenza viene generata una trascrizione.

Risorse che puoi monitorare per gli eventi

Per ricevere eventi, devi specificare una risorsa Meet da monitorare, che viene chiamata risorsa di destinazione dell'abbonamento.

L'API Google Workspace Events supporta le seguenti risorse di destinazione per Meet:

Tipi di eventi per la creazione di abbonamenti

Quando crei un abbonamento a una risorsa Meet, utilizzi il campo eventTypes[] per specificare i tipi di eventi che vuoi ricevere. I tipi di evento sono formattati in base alla specifica CloudEvents, ad esempio google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Ad esempio, per ricevere eventi sui nuovi partecipanti a una conferenza per uno spazio Meet, specifica 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 Meet modificata rappresentata nei dati degli eventi:

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 dell'evento. Questo payload contiene informazioni sulla risorsa Google Workspace modificata. Ad esempio, se hai eseguito l'iscrizione a eventi relativi a nuove trascrizioni in uno spazio, il payload di questi eventi contiene informazioni sulla risorsa transcript che è stata modificata.

Dati delle risorse nel payload dell'evento

La seguente tabella fornisce esempi di payload JSON per un abbonamento a uno spazio riunioni Meet. Gli esempi utilizzano l'ID record della conferenza (ad esempio, conferenceRecords/AAA-BBB-CCC-DDD-EEE) per identificare lo spazio della riunione. Per saperne di più, vedi Come Meet identifica uno spazio per le riunioni.

Per ogni evento ricevuto dall'abbonamento, il payload viene visualizzato nel campo data dell'evento:

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
      

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
      

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
      

{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}
      

Argomenti correlati

• Panoramica dell'API Google Workspace Events
• Struttura degli eventi di Google Workspace
• Scegliere gli ambiti dell'API Google Workspace Events
• Panoramica dell'API REST Google Meet
• Scegliere gli ambiti dell'API REST di Google Meet
• Tutorial: Osserva gli eventi delle riunioni con Python e l'API REST di Google Meet