En este documento, se explica cómo recibir eventos de Google Meet desde Google Cloud Pub/Sub y responder a ellos.
Un evento de Meet representa una actividad o un cambio en un recurso de Meet, como la creación de una reunión nueva. Puedes usar los eventos para comprender lo que sucedió y, luego, tomar medidas o responder de manera significativa a tus usuarios.
Estos son algunos ejemplos de cómo puedes usar los eventos:
Observar y responder a los cambios en una reunión, por ejemplo, cuando comienza o finaliza
Hacer un seguimiento de quién asistió a la reunión con fines reglamentarios o de capacitación
Escucha la transcripción de la reunión para que el contenido del archivo se pueda analizar y registrar en un CRM o una base de datos.
Cómo funcionan los eventos
Cada vez que sucede algo en Google Meet, se crea o actualiza un recurso de la API de REST de Google Meet. Meet usa eventos para entregar información a tu app sobre el tipo de actividad que ocurrió y el recurso de la API de REST de Meet que se vio afectado.
Space. Luego, Meet crea un evento
que contiene datos sobre el nuevo espacio de reunión.Meet categoriza los eventos por tipo. Los tipos de eventos te ayudan a filtrar y recibir solo el tipo de información que necesitas, y te permiten controlar actividades similares de la misma manera.
En el siguiente ejemplo, se muestra cómo una actividad en Meet afecta un recurso relacionado de la API de REST de Meet y el tipo de evento que recibe tu app de Meet:
| Actividad | Recurso de la API de Meet | Tipo de evento |
|---|---|---|
| Un usuario se une a un espacio de reunión. | Se crea un recurso ConferenceRecord. |
Nuevo récord de conferencia |
Recibe datos de eventos de Google Meet
Para recibir datos de eventos, tu app puede realizar cualquiera de las siguientes acciones:
Suscríbete a eventos con la API de Google Workspace Events para recibir eventos a medida que ocurren. Para obtener más información, consulta Cómo suscribirse a eventos de Google Meet.
Llama a la API de REST de Meet para consultar datos recientes.
En la siguiente tabla, se explican las diferencias y los motivos para suscribirse a eventos en lugar de consultarlos:
| Suscríbete a eventos | Cómo consultar datos | |
|---|---|---|
| Casos de uso |
|
|
| API | API de Google Workspace Events | API de Meet |
| Fuente de eventos | Registro de la conferencia y usuarios | Registro de espacio y conferencia |
| Eventos admitidos |
Registro de conferencias
Para obtener una lista de los tipos de eventos compatibles, consulta Tipos de eventos para crear suscripciones en la documentación de la API de Google Workspace Events. |
Registro de espacios y conferencias
Para obtener una lista de los extremos admitidos, consulta el recurso Space
y el recurso
ConferenceRecord
en la documentación de la API de REST de Meet.
|
| Formato del evento | Es un mensaje de Google Cloud Pub/Sub, con formato según la especificación de CloudEvent. Para obtener más detalles, consulta Estructura de los eventos de Google Workspace. |
Un recurso de la API de REST de Meet (Space y ConferenceRecord)
|
| Datos de eventos | Es una cadena codificada en Base64 con o sin datos de recursos. Para ver ejemplos de cargas útiles, consulta Datos de eventos. |
Es la carga útil JSON que contiene datos de recursos. Para ver un ejemplo de carga útil, consulta el recurso ConferenceRecord
en la documentación de referencia.
|
Ejemplo: Recupera eventos sobre los participantes en un espacio de reunión
En este ejemplo, una app de Meet quiere recibir información sobre los cambios de los participantes en un espacio de reunión. En el espacio de la reunión, un participante se une a una conferencia activa, lo que completa un recurso ParticipantSession y activa un evento nuevo. Luego, puedes obtener información sobre estos eventos con los métodos subscribe o query.
Suscríbete a eventos
Para recibir eventos en tiempo real, la app de Meet llama al método subscriptions.create de la API de Google Workspace Events para suscribirse al espacio de la reunión para todos los tipos de eventos. Después de crear la suscripción, la app de Meet puede comenzar a recibir eventos.
En la figura 2, la app de Meet tiene una suscripción activa al espacio de la reunión, por lo que recibe un evento cada vez que cambia la sesión de un participante en el espacio de la reunión. Luego, la app de Meet puede responder en tiempo real a cualquiera de las actividades, como saber cuándo un participante se une a una conferencia activa o la abandona.
Para obtener información sobre cómo crear suscripciones con la API de Google Workspace Events, consulta la documentación de la API de Google Workspace Events.
Consulta eventos recientes
En lugar de recibir eventos a medida que ocurren, una app de Meet también puede llamar a la API de REST de Meet para enumerar los eventos recientes del espacio de reuniones relacionados con la actividad de los participantes.
En la figura 3, una app de Meet llama al método conferenceRecords.participants.participantSessions.list de la API de REST de Meet después de que se hayan producido todas las actividades de la sesión de los participantes. La API de REST de Meet devuelve una lista de recursos ParticipantSession que representan cada uno de los cambios. Luego, la app de Meet puede procesar o responder en función de la actividad reciente, como crear una lista de los participantes que se unieron a la conferencia y la abandonaron.
Para consultar eventos con la API de REST de Meet, consulta Cómo enumerar todas las sesiones de participantes.
Limitaciones
- Los invitados al Calendario y otros participantes invitados a una conferencia solo pueden recibir los siguientes eventos:
google.workspace.meet.conference.v2.startedygoogle.workspace.meet.transcript.v2.fileGenerated.
Temas relacionados
- Descripción general de la API de Google Workspace Events
- Crea una suscripción a Google Workspace
- Suscríbete a eventos de Google Meet