Análisis por listas de reproducción

En este ejemplo, aprenderá a utilizar el CMS API y Analytics API juntos para seleccionar una lista de reproducción de su cuenta y obtener datos analíticos de todos los videos de la lista de reproducción.

CodePen

Código fuente

Encuentra todo el código asociado a este ejemplo en este repositorio de GitHub.

Aplicación de muestra

Ver la pluma Ejemplo de API de Analytics / CMS: Análisis por listas de reproducción por Brightcove Learning Services ( rcrooks1969 ) en CodePen.

Limitaciones

Debe recuperar los datos de la lista de reproducción y seleccionar una lista de reproducción antes de enviar la solicitud a la API de Analytics.
Para las listas de reproducción inteligentes, los datos analíticos se devolverán para los videos que se encuentran actualmente en la lista de reproducción; los datos no se devolverán para los videos que ya no están en la lista de reproducción porque se han desactivado, eliminado o eliminado debido a que la definición de la lista de reproducción ha cambiado.
Si alguno de los videos también se publica en reproductores de video únicos o en varias listas de reproducción, deberá especificar el reproductor para obtener datos precisos para una lista de reproducción específica.
Los datos devueltos incluyen los datos de videos individuales más valores acumulativos o promedio para la lista de reproducción.
Si los datos devueltos no incluyen elementos para todos los videos en la lista de reproducción, no se devolvieron datos para esos videos durante el período de tiempo especificado.

Lógica de la aplicación

Esta es una aplicación híbrida que usa el CMS API para recuperar la información de la lista de reproducción, y luego Analytics API para recuperar análisis de los videos en la lista de reproducción. Hay un pequeño giro: para la lista de reproducción EXPLÍCITA (manual), los metadatos incluyen los identificadores de video, por lo que podemos llevarlos directamente a la API de Analytics; para las listas de reproducción inteligentes, sin embargo, debemos volver a CMS API utilizando los criterios de búsqueda, clasificación y límite de la lista de reproducción para obtener la información del video, que luego podemos llevar a la API de Analytics:

Obtención de credenciales

Para obtener un client_id y client_secret, tendrás que ir a la interfaz de usuario de OAuth y registrar esta aplicación:

Administración de credenciales de autenticación de API

Estos son los permisos que necesitarás:

También puedes obtener tus credenciales a través de CURL o Postman. Consulta:

Si obtienes credenciales directamente de la API, estos son los permisos que necesitas:

      [
        "video-cloud/analytics/read",
        "video-cloud/video/read",
        "video-cloud/video/read"
      ]

Uso de CodePen

Estos son algunos consejos para utilizar eficazmente el CodePen anterior:

Alternar la visualización real de la aplicación haciendo clic en el Resultado botón.
Haga clic en el HTML / CSS / JS botones para mostrar UNO de los tipos de código.
Hacer clic Editar en CodePen en la esquina superior derecha para bifurcar este CodePen en su propia cuenta.
Encuentra todo el código asociado a este ejemplo en este repositorio de GitHub.

Código proxy

Para crear su propia versión de la aplicación de muestra en esta página, debe crear y alojar su propio proxy. (Los proxies utilizados por Brightcove Learning Services solo aceptan solicitudes de dominios de Brightcove.) Un proxy de ejemplo, muy similar al que usamos, pero sin las comprobaciones que bloquean solicitudes de dominios que no son de BrightCove, se puede encontrar en este repositorio de GitHub. También encontrará instrucciones básicas para utilizarlo allí y una guía más elaborada para crear aplicaciones alrededor del proxy en Uso de las API REST.