Analyse par listes de lecture

Dans cet exemple, vous apprendrez comment utiliser le CMS API et Analytics API ensemble pour sélectionner une playlist dans votre compte et obtenir des données d'analyse pour toutes les vidéos de la playlist.

Stylo de code

Code source

Retrouvez tout le code associé à cet exemple dans ce référentiel GitHub.

Exemple d'application

Voir le stylo Exemple d'API Analytics/CMS : Analyse par listes de lecture par Brightcove Learning Services (@rcrooks1969 ) au Stylo de code.

Contraintes

Vous devez récupérer les données de la playlist et sélectionner une playlist avant de soumettre la demande à l'API Analytics
Pour les playlists intelligentes, les données d'analyse seront renvoyées pour les vidéos actuellement dans la playlist - les données ne seront pas renvoyées pour les vidéos qui ne sont plus dans la playlist car elles ont été désactivées, supprimées ou supprimées car la définition de la playlist a changé
Si l'une des vidéos est également publiée dans un seul lecteur vidéo ou dans plusieurs listes de lecture, vous devrez spécifier le lecteur pour obtenir des données précises pour une liste de lecture spécifique.
Les données renvoyées incluent les données des vidéos individuelles ainsi que les valeurs cumulatives ou moyennes de la liste de lecture
Si les données renvoyées n'incluent pas d'éléments pour toutes les vidéos de la playlist, aucune donnée n'a été renvoyée pour ces vidéos au cours de la période spécifiée

Logique de l'application

Il s'agit d'une application hybride qui utilise CMS API pour récupérer les informations de la liste de lecture, puis Analytics API pour récupérer des analyses pour les vidéos de la liste de lecture. Il y a une légère tournure : pour la playlist EXPLICITE (manuelle), les métadonnées incluent les identifiants vidéo, de sorte que nous pouvons les apporter directement à l'API Analytics ; pour les playlists intelligentes, cependant, nous devons revenir à CMS API l'utilisation des critères de recherche, de tri et de limiter la liste de lecture à obtenir les informations vidéo, que nous pouvons ensuite apporter à l'API Analytics :

Obtention d'informations

Pour obtenir un client_id et client_secret, vous devez accéder à l'interface utilisateur OAuth et enregistrer cette application :

Gestion des informations d'identification d'authentification API

Voici les autorisations dont vous aurez besoin :

Vous pouvez également obtenir vos informations d'identification via CURL ou Postman - voir :

Si vous obtenez des informations d'identification directement à partir de l'API, voici les autorisations dont vous avez besoin :

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

Utilisation du CodePen

Voici quelques conseils pour utiliser efficacement le CodePen ci-dessus :

Basculez l'affichage réel de l'application en cliquant sur le bouton Résultat bouton.
Clique le HTML/CSS/JS pour afficher UN des types de code.
Cliquez sur Modifier sur CodePen dans le coin supérieur droit pour insérer ce CodePen dans votre propre compte.
Retrouvez tout le code associé à cet exemple dans ce référentiel GitHub.

Code proxy

Afin de créer votre propre version de l'exemple d'application sur cette page, vous devez créer et héberger votre propre proxy. (Les proxy utilisés par Brightcove Learning Services n'acceptent que les demandes des domaines Brightcove.) Un exemple de proxy, très similaire à celui que nous utilisons, mais sans les contrôles qui bloquent les demandes provenant de domaines non-BrightCove, peut être trouvé dans ce dépôt GitHub. Vous y trouverez également des instructions de base pour l'utiliser, ainsi qu'un guide plus détaillé sur la création d'applications autour du proxy dans Utilisation des API REST.