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:

  • Una conferenza inizia o termina in uno spazio riunione.
  • Un partecipante entra o esce da una conferenza.
  • Una registrazione inizia, termina o viene generato un file per una conferenza.
  • Una trascrizione inizia, termina o viene generato un file per una conferenza.

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.workspace.meet.conference.v2.started conferenceRecord
Una conferenza termina nello spazio per le riunioni. google.workspace.meet.conference.v2.ended conferenceRecord
Un partecipante si unisce a una conferenza attiva nello spazio della riunione. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Un partecipante abbandona una conferenza attiva nello spazio della riunione. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Inizia la registrazione di una conferenza nello spazio della riunione. google.workspace.meet.recording.v2.started conferenceRecord.recording
Una registrazione termina per una conferenza nello spazio riunioni. google.workspace.meet.recording.v2.ended conferenceRecord.recording
Viene generato un file di registrazione per una conferenza nello spazio della riunione. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Viene avviata una trascrizione per una conferenza nello spazio della riunione. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
La trascrizione termina per una conferenza nello spazio della riunione. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
Viene generato un file di trascrizione per una conferenza nello spazio della riunione. google.workspace.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

Una conferenza inizia o termina per lo spazio della riunione di Meet.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Esclude i dati delle risorse:

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Un partecipante entra o esce da una conferenza nello spazio riunioni di Meet.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Esclude i dati delle risorse:

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
Una registrazione inizia, termina o viene generato un file per una conferenza nello spazio della riunione di Meet.
  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

Esclude i dati delle risorse:

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Una trascrizione inizia, termina o viene generato un file per una conferenza nello spazio riunioni di Meet.
  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • 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.