Iscriviti agli eventi di Google Meet

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

Oltre a iscriverti agli eventi, puoi anche eseguire query per gli eventi chiamando l'API REST di Google Meet. Chiama l'API REST di Meet per recuperare gli eventi su base periodica o recupera gli eventi che potresti aver perso da un abbonamento a causa di un'interruzione. Per scoprire i modi in cui puoi ricevere e rispondere agli eventi di Meet, consulta Rispondere agli eventi da Google Meet nella documentazione di 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:

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:

Risorsa di destinazione Formato Limitazioni (se applicabile)
Spazio per le riunioni //meet.googleapis.com/spaces/SPACE

dove SPACE è l'ID nel nome della risorsa della risorsa spaces dell'API REST di Meet. Per maggiori dettagli, vedi Come Meet identifica uno spazio per le riunioni.
Utente //cloudidentity.googleapis.com/users/USER

dove USER è l'ID nel campo signedinUser.user della risorsa participants dell'API REST di Meet. Per maggiori dettagli, vedi Lavorare con i partecipanti.

L'abbonamento riceve eventi relativi a tutti gli spazi per le riunioni di cui l'utente è proprietario. In genere, il proprietario dello spazio per le riunioni è anche l'organizzatore dell'evento di Google Calendar associato allo spazio per le riunioni.

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 per gli abbonamenti alle risorse di Meet:

Tipo di evento Formato Dati delle risorse
Una conferenza inizia nello spazio della riunione. google.meet.conference.v2.started conferenceRecord
Una conferenza termina nello spazio per le riunioni. google.meet.conference.v2.ended conferenceRecord
Un partecipante si unisce a una conferenza attiva nello spazio della riunione. google.meet.participant.v2.joined conferenceRecord.participantSession
Un partecipante abbandona una conferenza attiva nello spazio della riunione. google.meet.participant.v2.left conferenceRecord.participantSession
Viene generato un file di registrazione per una conferenza nello spazio della riunione. google.meet.recording.v2.fileGenerated conferenceRecord.recording
Viene generato un file di trascrizione per una conferenza nello spazio della riunione. google.meet.transcript.v2.fileGenerated 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 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 transcripts 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 di Meet. Gli esempi utilizzano l'ID record conferenza (ad esempio, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) per identificare lo spazio per le riunioni. 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:

Esempio Tipo di evento Payload JSON

Viene avviata una conferenza per lo spazio riunioni di Meet.

google.workspace.meet.conference.v2.started
Esclude i dati delle risorse
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Un partecipante si unisce a una conferenza nello spazio della riunione di Meet.

google.workspace.meet.participant.v2.joined
Esclude i dati delle risorse
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
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/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
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/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

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.