Iscriviti agli eventi di Google Meet

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

Eventi di Meet supportati

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

Risorse che puoi monitorare per gli eventi

Per ricevere eventi, devi specificare una risorsa Meet da monitorare, denominata risorsa di destinazione della sottoscrizione.

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

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

dove SPACE è l'ID nella nome risorsa della risorsa space dell'API REST Meet. Per maggiori dettagli, vedi Come Meet identifica uno spazio per le riunioni.

Utente //cloudidentity.googleapis.com/users/USER

dove USER è l'ID nella Campo signedinUser.user della risorsa API REST Meet participant. Per maggiori dettagli, vedi Collabora con i partecipanti.

L'abbonamento riceve gli eventi relativi agli spazi per riunioni in cui L'utente può essere uno dei seguenti:

  • Il proprietario dello spazio per le riunioni.
  • L'organizzatore dell'evento di Google Calendar associato allo spazio per le riunioni.

Tipi di eventi per la creazione di sottoscrizioni

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

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

Tipo di evento Descrizione Risorsa Meet

google.workspace.meet.conference.v2.started

Una conferenza inizia nello spazio per le riunioni.

conferenceRecord

google.workspace.meet.conference.v2.ended

La conferenza termina nello spazio per le riunioni.

conferenceRecord

google.workspace.meet.participant.v2.joined

Un partecipante partecipa a una conferenza attiva nello spazio della riunione.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Un partecipante abbandona una conferenza attiva nello spazio della riunione.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

Viene generato un file di registrazione per una conferenza nello spazio della riunione.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Viene generato un file di trascrizione per una conferenza nello spazio della riunione.

conferenceRecord.transcript

Dati sugli eventi

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

Quando il tuo abbonamento a Google Workspace riceve un evento da Meet, il data contiene il payload per l’evento. Questo payload contiene informazioni Risorsa Google Workspace modificata. Ad esempio, se hai sottoscritto un abbonamento a eventi su nuove trascrizioni in uno spazio, il payload per questi eventi informazioni sui transcript risorsa che è stata modificata.

Dati delle risorse nel payload dell'evento

La tabella seguente fornisce esempi di payload JSON per una sottoscrizione a uno spazio per riunioni di Meet. Gli esempi utilizzano 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 della dell'evento:

Esempio Tipo di evento Payload JSON

Viene avviata una conferenza per lo spazio delle 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 delle 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 delle 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 delle 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"
    }
}