assistance Contacter le support | Étatétat du système du système
Contenu de la page

    Résultats de recherche de page

    Dans cette rubrique, vous apprendrez comment implémenter la pagination pour les résultats des CMS API demandes, lorsque la demande correspond à plus d'éléments que vous ne pouvez renvoyer en même temps. Cela vous permet de gérer des jeux de résultats volumineux dans des groupes plus petits, ce qui améliore les performances. Un maximum de 100 enregistrements seront renvoyés à partir d'une seule requête à l'API CMS, mais pour les jeux de résultats volumineux, nous vous recommandons de récupérer 25 éléments par demande pour de meilleures performances.

    Procédure

    Pour gérer la pagination des données, procédez comme suit :

    • Récupère le nombre total d'enregistrements dans le jeu de résultats.
    • Calculez le nombre de pages pour votre jeu de résultats.
    • Bouclez et appelez le CMS API pour chaque page de données.

    Obtenir 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 varie en fonction de vos critères de recherche. Utilisez la 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 à l'aide du q paramètre facultatif. Pour plus d'informations sur l'utilisation des critères de recherche avec ce paramètre, consultez la section Utilisation de l'API CMS : Recherche dans le document Vidéos .

    Exemple : Ici, nous obtenons le nombre de vidéos qui ont une valeur de tag de la faune.

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

    Réponse :

        {
            "count" : 6
        }

    Calculer pages

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

    Vous pouvez définir une taille 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 les pages

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

    Cet exemple renvoie 10 vidéos à partir de la 21ème vidéo de votre jeu de résultats.

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

    Vous pouvez également inclure le q paramètre facultatif. Pour plus d'informations sur l'utilisation des critères de recherche avec ce paramètre, consultez la section Utilisation de l'API CMS : Recherche dans le document Vidéos .

    Cette demande renvoie 2 vidéos à partir de la 5ème vidéo du jeu de résultats de vidéos qui ont une valeur de tag de la faune.

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