Iscriviti agli eventi di Google Meet

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

Oltre ad abbonarti agli eventi, puoi anche eseguire query sugli eventi chiamando l'API REST di Google Meet. Chiama l'API REST di Meet per recuperare gli eventi periodicamente o per recuperare gli eventi che potresti aver perso da un abbonamento a causa di un'interruzione. Per scoprire di più sui modi in cui puoi ricevere e rispondere agli eventi di Meet, consulta Rispondere agli eventi di Meet nella documentazione di Meet.

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

Eventi di Meet supportati

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

  • Una conferenza inizia o termina in uno spazio per le riunioni.
  • Un partecipante entra o esce da una conferenza.
  • Una registrazione inizia, termina o viene generato un file per una conferenza.
  • Una nota intelligente 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, specifica una risorsa di Meet da monitorare, 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 applicabili)
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 signedinUser.user campo della risorsa participants dell'API REST di Meet. Per maggiori dettagli, vedi Utilizzare i partecipanti.

L'abbonamento riceve eventi relativi a tutti gli spazi per le riunioni in cui l' utente è il proprietario dello spazio per le riunioni. In genere, il proprietario dello spazio per le riunioni è anche il 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 di Meet, utilizza il eventTypes[] campo per specificare i tipi di eventi che vuoi ricevere. I tipi di eventi sono formattati in base alla CloudEvents, ad esempio google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Ad esempio, per ricevere eventi sui nuovi partecipanti a una conferenza per uno spazio di Meet, specifica il tipo di evento come google.workspace.meet.participant.v2.joined. Per scoprire di più sul funzionamento degli eventi work, consulta Struttura degli eventi di Google Workspace events.

La seguente tabella 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 per le riunioni. google.workspace.meet.conference.v2.started conferenceRecord
Una conferenza termina nello spazio per le riunioni. google.workspace.meet.conference.v2.ended conferenceRecord
Un partecipante entra in una conferenza attiva nello spazio per le riunioni. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Un partecipante esce da una conferenza attiva nello spazio per le riunioni. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Inizia la registrazione di una conferenza nello spazio per le riunioni. google.workspace.meet.recording.v2.started conferenceRecord.recording
Termina la registrazione di una conferenza nello spazio per le riunioni. google.workspace.meet.recording.v2.ended conferenceRecord.recording
Viene generato un file di registrazione per una conferenza nello spazio per le riunioni. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Inizia una nota intelligente per una conferenza nello spazio per le riunioni. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Termina una nota intelligente per una conferenza nello spazio per le riunioni. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Viene generato un file di note intelligenti per una conferenza nello spazio per le riunioni spazio. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
Inizia una trascrizione per una conferenza nello spazio per le riunioni. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Termina una trascrizione per una conferenza nello spazio per le riunioni. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
Viene generato un file di trascrizione per una conferenza nello spazio per le riunioni spazio. google.workspace.meet.transcript.v2.fileGenerated conferenceRecord.transcript

Dati sugli eventi

Questa sezione descrive i dati degli 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 data campo contiene il payload dell'evento. Questo payload contiene informazioni sulla risorsa di Google Workspace che è stata modificata. Ad esempio, se ti sei abbonato agli eventi relativi alle nuove trascrizioni in uno spazio, il payload di questi eventi contiene informazioni sulla transcripts risorsa che è stata modificata.

Dati delle risorse nel payload dell'evento

La seguente tabella fornisce esempi di payload JSON per un abbonamento a uno spazio per le riunioni di Meet. Gli esempi utilizzano l'ID del record della conferenza (ad esempio, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) per identificare lo spazio per le riunioni. Per maggiori informazioni, vedi Come Meet identifica uno spazio per le riunioni .

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

Tipi di eventi Payload JSON

Una conferenza inizia o termina per lo spazio per le riunioni 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 per le 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 per le riunioni 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 nota intelligente inizia, termina o viene generato un file per una conferenza nello spazio per le riunioni di Meet.

  • google.workspace.meet.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

Esclude i dati delle risorse:

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}

Una trascrizione inizia, termina o viene generato un file per una conferenza nello spazio per le 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.