Reuniones y Seminarios web con un solo participante

Elisa
Tue, 22 Feb 2022 15:50:47 +0000
API and Webhooks

Mostrar los seminarios web y las reuniones unipersonales en el panel de control y en los informes

Los puntos de acceso o APIs designados para Dashboard/Panel de control y Reports/Informes, son excelentes herramientas para los clientes de Zoom que buscan obtener datos detallados de una gran variedad de funciones Zoom, con la primordial funcionalidad de generación de reportes y análisis de datos.

Cuando nos encontramos con reuniones o seminarios web con un solo participante, es importante hacer llamadas a la API con los query parameters apropiados, dependiendo del tipo de reunión que se está tratando obtener.

En la documentación para Dashboard y Reportes, al query parameter type(tipo) se le pueden asignar tres diferentes valores “past”, “pastOne” y el valor predeterminado “live”

zoomvideocommunications

Zoom Meeting API

The Zoom Meeting APIs let developers to access information from Zoom. You can use this API to build private services or public applications on the Zoom App Marketplace. To learn how to get your credentials and create private/p...

zoomvideocommunications

Zoom Meeting API

The Zoom Meeting APIs let developers to access information from Zoom. You can use this API to build private services or public applications on the Zoom App Marketplace. To learn how to get your credentials and create private/p...

Cuando se llaman estos puntos de acceso o APIs de manera programática y para evitar tener que cambiar el valor del query parameter o tipo de parámetro de consulta type de “past” a “pastOne” cada vez que nos encontramos con una reunión o seminario web con un solo participante, Zoom ofrece una funcionalidad que permite a los desarrolladores hacer solicitudes al endpoint a todas las reuniones en el pasado (incluidas las reuniones pasadas a las que asistió un solo usuario), con el mismo tipo de parámetro de consulta “past”

Pre requisitos

Para habilitar esta funcionalidad, la cuenta debe contar con un plan Business o superior.

dashboard_meetings:read:admin para aplicaciones Oauth Apps.

Se puede acceder a estos endpoints con credenciales JWT. (account level only)

¿Cómo habilitar dicha funcionalidad?

Esta funcionalidad debe ser habilitada por el administrador de la cuenta siguiendo los siguientes pasos:
Administración de Cuenta > Ajustes de Cuenta > Opciones de administración >
“Mostrar los seminarios web y las reuniones unipersonales en el panel de control y en los informes”

Nota:

Todos las reuniones o webinars pasados con un solo participante que se llevaron acabo antes de activar esta funcionalidad en la cuenta, se deberán seguir llamando con el parámetro de consulta/ query parameter type “pastOne”

Ejemplo usando postman

Punto de acceso: Get meeting details

zoomvideocommunications

Zoom Meeting API

The Zoom Meeting APIs let developers to access information from Zoom. You can use this API to build private services or public applications on the Zoom App Marketplace. To learn how to get your credentials and create private/p...

Request URL: GET https://api.zoom.us/v2/metrics/meetings/85775354809?type=past
Response Body:

En el ejemplo anterior, noten como el valor de “participants” es 1 y el query parameter “type” es “past”. Si llamamos a la API nuevamente con el query parameter “type” “pastOne”, una vez configurada esta funcionalidad, nos devolverá un error 3001: Meeting does not exist.

Importante:
Cuando se active la propiedad “Mostrar los seminarios web y las reuniones unipersonales en el panel de control y en los informes”, todos los puntos de acceso referentes a Dashboards y Reportes serán accesibles con el query param “past” incluyendo Get meeting detail reports Zoom Meeting API

Espero que este post les ayude a descubrir y entender esta funcionalidad de manera práctica y la puedan implementar en futuros programas!

Saludos y no olviden compartir temas que les gustaría leer en Español!

Elisa

3 posts - 2 participants