페이지 검색 결과

이 항목에서는CMS API요청이 한 번에 반환할 수 있는 항목보다 많은 항목과 일치하는 경우 요청 결과에 대한 페이징을 구현하는 방법을 알아봅니다. 이렇게 하면 작은 그룹으로 큰 결과 집합을 처리할 수 있으므로 성능이 향상됩니다. 단일 요청에서 CMS API로 최대 100개의 레코드가 반환되지만 큰 결과 집합의 경우 성능 향상을 위해 요청당 25개의 항목을 가져오는 것이 좋습니다.

순서

데이터 페이징을 처리하려면 다음 단계를 따르십시오.

  • 결과 집합의 총 레코드 수를 가져옵니다.
  • 결과 세트의 페이지 수를 계산하십시오.
  • 각 데이터 페이지에CMS API대해 반복해서 를 호출합니다.

기록 수 얻기

먼저 결과 집합의 총 비디오 수를 알아야합니다. 결과 집합의 응답은 검색 기준에 따라 다릅니다. counts리소스를 사용하면 결과 집합의 총 레코드 수를 반환할 수 있습니다.

예: 계정의 총 동영상 수를 가져옵니다.

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

응답:

    {
        "count" : 74
    }

선택적q매개 변수를 사용하여 개수를 제한할 수도 있습니다. 이 파라미터와 함께 검색 기준을 사용하는 방법에 대한 자세한 내용은 CMS API 사용을 참조하십시오. 비디오문서 검색.

예: 여기서는야생동물이라는 태그 값을 가진 동영상의 수를 확인할 수있습니다.

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

응답:

    {
        "count" : 6
    }

페이지 계산

페이지 수를 계산하려면 결과 집합의 총 레코드 수를 페이지 당 레코드 수 (페이지 크기)로 나눕니다.

고정 페이지 크기를 설정하거나 웹 페이지에 비디오 데이터를 표시하는 경우 사용자가 페이지 크기 (즉, 페이지 당 비디오 데이터 개체 수)를 동적으로 설정하도록 할 수 있습니다.

자바스크립트 예제:

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

페이지 검색

이전 단계에서 계산한 페이지 수를 반복하고CMS API와 더불어limit그리고offset데이터의 연속적인 하위 집합을 검색하기 위한 매개변수.

이 예는 결과 집합에서 21 번째 동영상으로 시작하는 10 개의 동영상을 반환합니다.

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

선택적q매개 변수를 포함할 수도 있습니다. 이 파라미터와 함께 검색 기준을 사용하는 방법에 대한 자세한 내용은 CMS API 사용을 참조하십시오. 비디오문서 검색.

이 요청은 결과 집합의 다섯 번째 동영상부터 시작하여야생동물이라는 태그 값을 가진 2개의 동영상을 반환합니다 .

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

알려진 문제

  • 중복 결과:경우에 따라 검색 결과의 일부 항목이 두 번 이상 나타날 수 있습니다.

    해결 방법: 검색 결과가 중복되지 않도록하려면 항상 검색 요청에sort매개 변수를 사용하십시오.