Suscríbete a eventos de Google Meet

En este documento, se describen los eventos de Meet a los que se puede suscribir tu app 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 consultar eventos 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 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 y responder eventos de Meet, consulta Cómo responder a eventos de Google 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 termina en un espacio de reunión.
  • Un participante se une a una conferencia o la abandona.
  • Se inicia o finaliza una grabación, o se genera un archivo para una conferencia.
  • Se inicia o finaliza una nota inteligente, o se genera un archivo para una conferencia.
  • Se inicia o finaliza una transcripción, o se genera un archivo para una conferencia.

Recursos que puedes supervisar para detectar eventos

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

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

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

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

en el que USER es el ID en el campo signedinUser.user del recurso participants de la API de REST de Meet. Para obtener más detalles, consulta Cómo trabajar con participantes.

La suscripción recibe eventos sobre todas las salas de reuniones en las que el usuario es el propietario de la sala de reuniones. Por lo general, el propietario del espacio de reunión también es el organizador del evento de Calendario de Google asociado al espacio de reunión.

Tipos de eventos para crear suscripciones

Cuando crees una suscripción a un recurso de Meet, usa el campo eventTypes[] para especificar qué tipos de eventos quieres recibir. Los tipos de eventos tienen el formato de acuerdo con la especificación de CloudEvents, como google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Por ejemplo, para recibir eventos sobre participantes nuevos en una conferencia de 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 que se admiten para las suscripciones a los recursos de Meet:

Tipo de evento Formato Datos de recursos
Se inicia una conferencia en el espacio de reunión. google.workspace.meet.conference.v2.started conferenceRecord
Finaliza una conferencia en el espacio de reunión. google.workspace.meet.conference.v2.ended conferenceRecord
Un participante se une a una conferencia activa en la sala de reuniones. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Un participante abandona una conferencia activa en la sala de reuniones. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Se inicia una grabación para una conferencia en el espacio de la reunión. google.workspace.meet.recording.v2.started conferenceRecord.recording
Finaliza una grabación de una conferencia en el espacio de reunión. google.workspace.meet.recording.v2.ended conferenceRecord.recording
Se genera un archivo de grabación para una conferencia en el espacio de la reunión. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Se inicia una nota inteligente para una reunión en la sala de reuniones. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Finaliza una nota inteligente para una conferencia en el espacio de reunión. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Se genera un archivo de notas inteligentes para una conferencia en el espacio de la reunión. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
Se inicia una transcripción para una conferencia en la sala de reuniones. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Finaliza una transcripción de una conferencia en la sala de reuniones. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
Se genera un archivo de transcripción para una conferencia en el espacio de la reunión. 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 reunión de Meet.

Cuando tu suscripción a Google Workspace recibe un evento de Meet, el campo data 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 recurso transcripts 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 reunión de Meet. En los ejemplos, se usa el ID del registro de conferencia (por ejemplo, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) para identificar el espacio de reunión. Para obtener más información, consulta Cómo Meet identifica un espacio de reunión.

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

Tipos de eventos Carga útil de tipo JSON

Se inicia o finaliza una conferencia en el espacio de la reunión de Meet.

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

Excluye los datos de los recursos:

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

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

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

Excluye los datos de los recursos:

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

Se inicia 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 los recursos:

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

Se inicia 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 los recursos:

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

Se inicia 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 los recursos:

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

Limitaciones
  • Los invitados del 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.