Paper Contacter le support | état du système L'état du système
Contenu de la page

    Résultats de recherche de page

    Dans cette rubrique, vous apprendrez à mettre en œuvre la pagination pour obtenir les résultats de CMS API demandes, lorsque la demande correspond à plus d'éléments que vous ne pouvez en retourner en même temps. Cela vous permet de gérer des ensembles de résultats volumineux dans des groupes plus petits, ce qui améliore les performances. Un maximum d'enregistrements 100 sera renvoyé à partir d'une seule demande au CMS API, mais pour les jeux de résultats volumineux, nous vous recommandons d’extraire des éléments 25 par requête pour améliorer les performances.

    Procédure

    Pour gérer la pagination des données, vous devez suivre ces étapes:

    • Obtenez le nombre total d'enregistrements dans le jeu de résultats.
    • Calculez le nombre de pages pour votre jeu de résultats.
    • Faites une boucle et appelez le CMS API pour chaque page de données.

    Obtenez le nombre d'enregistrements

    Tout d'abord, vous devez connaître le nombre total de vidéos dans votre jeu de résultats. La réponse dans le jeu de résultats variera en fonction de vos critères de recherche. Utilisez le counts ressource pour renvoyer un nombre total d'enregistrements dans votre jeu de résultats.

    Exemple: obtenez le nombre total de vidéos dans votre compte:

        https://cms.api.brightcove.com/v1/accounts/921483702001/counts/videos

    Réponse:

        {
            "count" : 74
        }

    Vous pouvez également limiter le nombre en utilisant l'option q paramètre. Pour plus de détails sur l'utilisation de critères de recherche avec ce paramètre, voir En utilisant l' CMS API: Rechercher des vidéos document.

    Exemple: Ici nous obtenons le nombre de vidéos qui ont une valeur d'étiquette de faune.

        https://cms.api.brightcove.com/v1/accounts/921483702001/counts/videos?q=tags:wildlife

    Réponse:

        {
            "count" : 6
        }

    Calculer des pages

    Pour calculer le nombre de pages, prenez le nombre total d'enregistrements dans votre jeu de résultats et divisez-le par le nombre d'enregistrements par page (taille de la page).

    Vous pouvez définir un format de page fixe ou, si vous affichez des données vidéo sur une page Web, vous pouvez laisser l'utilisateur définir dynamiquement la taille de la page (par exemple, le nombre d'objets de données vidéo par page).

    Exemple JavaScript:

        var numberOfPages = Math.ceil(jsonData.count / pageSize);

    Récupérer des pages

    Parcourez le nombre de pages que vous avez calculé à l'étape précédente et appelez le CMS API des limit et offset paramètres pour récupérer des sous-ensembles successifs de données.

    Cet exemple renvoie des vidéos 10 commençant par la vidéo 21st dans votre jeu de résultats.

        https://cms.api.brightcove.com/v1/accounts/921483702001/videos?limit=10&offset=20

    Vous pouvez également inclure l'option q paramètre. Pour plus de détails sur l'utilisation de critères de recherche avec ce paramètre, voir En utilisant l' CMS API: Rechercher des vidéos document.

    Cette requête renvoie les vidéos 2 commençant par la vidéo 5th du jeu de résultats contenant une valeur de balise de faune.

        https://cms.api.brightcove.com/v1/accounts/921483702001/videos?q=tags:wildlife&limit=2&offset=4

    Dernière mise à jour de la page le 12 juin 2020