Suscríbete a eventos de Google Meet

En este documento, se describen los eventos de Meet a los que tu app puede suscribirse con la API de Google Workspace Events. Después de decidir qué tipos de eventos necesitas, crea una suscripción para comenzar a recibir eventos de Meet.

Además de suscribirte a eventos, también puedes consultarlos llamando a la API de REST de Google Meet. Llama a la API de REST de Meet para recuperar eventos de forma periódica o para ponerte al día con los eventos que podrías haberte perdido de una suscripción debido a una interrupción. Para obtener información sobre las formas en que puedes recibir eventos de Meet y responder a ellos, consulta Cómo responder a eventos de Meet en la documentación de Meet.

Para obtener más información sobre el desarrollo de apps para Meet, consulta la descripción general de la API de REST de Meet.

Eventos de Meet admitidos

Las suscripciones a Google Workspace te permiten recibir eventos sobre los siguientes tipos de cambios en Meet:

  • Una conferencia comienza o finaliza en un espacio de reuniones.
  • Un participante se une a una conferencia o la abandona.
  • Comienza o finaliza una grabación, o se genera un archivo para una conferencia.
  • Comienza o finaliza una nota inteligente, o se genera un archivo para una conferencia.
  • Comienza o finaliza una transcripción, o se genera un archivo para una conferencia.

Recursos que puedes supervisar para eventos

Para recibir eventos, especifica un recurso de Meet para supervisar, que se denomina recurso objetivo de la suscripción.

La API de Google Workspace Events admite los siguientes recursos objetivos para Meet:

Recurso objetivo Formato Limitaciones (si corresponde)
Espacio de reuniones //meet.googleapis.com/spaces/SPACE

donde SPACE es el ID en el nombre del recurso de la API de REST de Meet spaces resource. Para obtener más información, consulta Cómo Meet identifica un espacio de reuniones.
Usuario //cloudidentity.googleapis.com/users/USER

donde USER es el ID en el signedinUser.user campo del recurso participants de la API de REST de Meet. Para obtener más información, consulta Trabaja con participantes.

La suscripción recibe eventos sobre todos los espacios de reuniones en los que el usuario es el propietario del espacio de reuniones. Por lo general, el propietario del espacio de reuniones también es el elorganizador del evento de Calendario de Google asociado con el espacio de reuniones.

Tipos de eventos para crear suscripciones

Cuando creas una suscripción a un recurso de Meet, usa el eventTypes[] para especificar qué tipos de eventos deseas recibir. Los tipos de eventos se formatean según la CloudEvents, como google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Por ejemplo, para recibir eventos sobre participantes nuevos en una conferencia para un espacio de Meet, especifica el tipo de evento como google.workspace.meet.participant.v2.joined. Para obtener más información sobre cómo funcionan los eventos, consulta Estructura de los eventos de Google Workspace.

En la siguiente tabla, se muestran los tipos de eventos admitidos para las suscripciones a recursos de Meet:

Tipo de evento Formato Datos de recursos
Comienza una conferencia en el espacio de reuniones. google.workspace.meet.conference.v2.started conferenceRecord
Finaliza una conferencia en el espacio de reuniones. google.workspace.meet.conference.v2.ended conferenceRecord
Un participante se une a una conferencia activa en el espacio de reuniones. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Un participante abandona una conferencia activa en el espacio de reuniones. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Comienza una grabación para una conferencia en el espacio de reuniones. google.workspace.meet.recording.v2.started conferenceRecord.recording
Finaliza una grabación para una conferencia en el espacio de reuniones. google.workspace.meet.recording.v2.ended conferenceRecord.recording
Se genera un archivo de grabación para una conferencia en el espacio de reuniones. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Comienza una nota inteligente para una conferencia en el espacio de reuniones. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Finaliza una nota inteligente para una conferencia en el espacio de reuniones. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Se genera un archivo de nota inteligente para una conferencia en el espacio de reuniones. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
Comienza una transcripción para una conferencia en el espacio de reuniones. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Finaliza una transcripción para una conferencia en el espacio de reuniones. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
Se genera un archivo de transcripción para una conferencia en el espacio de reuniones. google.workspace.meet.transcript.v2.fileGenerated conferenceRecord.transcript

Datos de eventos

En esta sección, se describen los datos de eventos y las cargas útiles de ejemplo para los eventos en los espacios de reuniones de Meet.

Cuando tu suscripción a Google Workspace recibe un evento de Meet, el data campo contiene la carga útil del evento. Esta carga útil tiene información sobre el recurso de Google Workspace que cambió. Por ejemplo, si te suscribiste a eventos sobre transcripciones nuevas en un espacio, la carga útil de estos eventos contiene información sobre el transcripts recurso que cambió.

Datos de recursos en la carga útil del evento

En la siguiente tabla, se proporcionan ejemplos de cargas útiles de JSON para una suscripción a un espacio de reuniones de Meet. En los ejemplos, se usa el ID de registro de la conferencia (por ejemplo, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) para identificar el espacio de reuniones. Para obtener más información, consulta Cómo Meet identifica un espacio de reuniones.

Para cada evento que recibe la suscripción, la carga útil aparece en el campo data del evento:

Tipos de eventos Carga útil de JSON

Comienza o finaliza una conferencia para el espacio de reuniones de Meet.

  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Excluye los datos de recursos:

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}

Un participante se une a una conferencia o la abandona en el espacio de reuniones de Meet.

  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Excluye los datos de recursos:

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}

Comienza o finaliza una grabación, o se genera un archivo para una conferencia en el espacio de reuniones de Meet.

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

Excluye los datos de recursos:

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}

Comienza o finaliza una nota inteligente, o se genera un archivo para una conferencia en el espacio de reuniones de Meet.

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

Excluye los datos de recursos:

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

Comienza o finaliza una transcripción, o se genera un archivo para una conferencia en el espacio de reuniones de Meet.

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

Excluye los datos de recursos:

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}

Limitaciones
  • Los invitados de Calendario y otros participantes invitados a una conferencia solo pueden recibir los siguientes eventos: google.workspace.meet.conference.v2.started y google.workspace.meet.transcript.v2.fileGenerated.