Resultados de búsqueda de páginas

En este tema, aprenderá cómo implementar la paginación para los resultados de CMS API solicitudes, cuando la solicitud coincide con más artículos de los que puede devolver al mismo tiempo. Esto le permite manejar grandes conjuntos de resultados en grupos más pequeños, lo que mejora el rendimiento. Se devolverá un máximo de registros 100 de una sola solicitud al CMS API, pero para conjuntos de resultados grandes, recomendamos obtener elementos 25 por solicitud para un mejor rendimiento.

Procedimiento

Para manejar la búsqueda de datos, debe seguir estos pasos:

Obtenga un recuento de la cantidad total de registros en el conjunto de resultados.
Calcule el número de páginas para su conjunto de resultados.
Recorrer y llamar al CMS API para cada página de datos.

Obtenga el recuento de registros

Primero, necesita saber la cantidad total de videos en su conjunto de resultados. La respuesta en el conjunto de resultados variará según sus criterios de búsqueda. Utilizar el counts recurso para devolver un recuento total de registros en su conjunto de resultados.

Ejemplo: obtenga el recuento total de videos en su cuenta:

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

Respuesta:

    {
        "count" : 74
    }

También puede limitar el recuento utilizando la opción q parámetro. Para obtener detalles sobre el uso de criterios de búsqueda con este parámetro, consulte la Usando el patrón de velas del CMS API: Buscar Videos documento.

Ejemplo: Aquí obtenemos la cantidad de videos que tienen un valor de etiqueta de fauna.

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

Respuesta:

    {
        "count" : 6
    }

Calcular páginas

Para calcular el número de páginas, tome la cantidad total de registros en su conjunto de resultados y divídala por el número de registros por página (tamaño de página).

Puede establecer un tamaño de página fijo, o si está mostrando datos de video en una página web, puede permitir que el usuario establezca dinámicamente el tamaño de página (es decir, el número de objetos de datos de video por página).

Ejemplo de JavaScript:

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

Recuperar páginas

Recorra el número de páginas que calculó en el paso anterior y llame al CMS API con limit y offset parámetros para recuperar subconjuntos sucesivos de datos.

Este ejemplo devuelve videos 10 que comienzan con el video 21st en su conjunto de resultados.

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

También puede incluir el opcional q parámetro. Para obtener detalles sobre el uso de criterios de búsqueda con este parámetro, consulte la Usando el patrón de velas del CMS API: Buscar Videos documento.

Esta solicitud devuelve videos 2 comenzando con el video 5th del conjunto de resultados de videos que tienen un valor de etiqueta de fauna.

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