Iscriviti agli eventi di Google Meet

Questo documento descrive gli eventi di 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 sugli eventi chiamando l'API REST di Google Meet. Chiama l'API REST di Meet per recuperare periodicamente gli eventi o per recuperare 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 Rispondi agli eventi di Google 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 relativi ai seguenti tipi di modifiche in Meet:

  • Una conferenza inizia o termina in uno spazio riunioni.
  • Un partecipante partecipa o abbandona una conferenza.
  • Una registrazione inizia, termina o viene generato un file per una conferenza.
  • Una nota smart viene avviata, terminata 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 gli eventi, specifica una risorsa 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 Limitations (if applicable)
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 In che modo Meet identifica uno spazio per 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 Lavora con i partecipanti.

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

Tipi di eventi per la creazione di sottoscrizioni

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

Ad esempio, per ricevere eventi relativi ai 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, consulta Struttura degli eventi di Google Workspace.

La tabella seguente mostra i tipi di eventi supportati per le iscrizioni 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 riunioni. google.workspace.meet.conference.v2.ended conferenceRecord
Un partecipante si unisce a una conferenza attiva nello spazio riunioni. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Un partecipante abbandona una conferenza attiva nello spazio riunioni. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Viene avviata una registrazione per 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 riunioni. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Viene avviata una nota intelligente per una conferenza nello spazio della riunione. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Una nota intelligente termina per una conferenza nello spazio della riunione. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Viene generato un file di note intelligenti per una conferenza nello spazio della riunione. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
Viene avviata una trascrizione per una conferenza nello spazio della riunione. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Una trascrizione termina per una conferenza nello spazio riunioni. 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 di riunione 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 che è stata modificata. Ad esempio, se hai sottoscritto eventi relativi a nuove trascrizioni in uno spazio, il payload di questi eventi contiene informazioni sulla risorsa transcripts che è cambiata.

Dati della risorsa nel payload dell'evento

La tabella seguente fornisce esempi di payload JSON per un abbonamento a uno spazio di riunione di Meet. Gli esempi utilizzano l'ID record della conferenza (ad esempio, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) per identificare lo spazio per le riunioni. Per saperne di più, vedi In che modo Meet identifica uno spazio riunione.

Per ogni evento ricevuto dalla sottoscrizione, il payload viene visualizzato nel campo data dell'evento:

Tipi di eventi 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 partecipa o abbandona 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 nota smart viene avviata, terminata o viene generato un file per una conferenza nello spazio 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 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.