手順
データページングを処理するには、次の手順に従います。
- 結果セット内のレコードの総数のカウントを取得します。
- 結果セットのページ数を計算します。
- ループして、 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
}
ページを計算する
ページ数を計算するには、結果セット内のレコードの総数を取得し、それをページあたりのレコード数(ページサイズ)で割ります。
固定ページサイズを設定できます。または、ビデオデータをWebページに表示している場合は、ユーザーがページサイズ(つまり、ページあたりのビデオデータオブジェクトの数)を動的に設定できるようにすることができます。
JavaScriptの例:
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 の使用:ビデオドキュメントを検索します。
このリクエストは、タグ値がの動画の結果セットから5番目の動画から始まる2つの動画を返します。野生動物。
https://cms.api.brightcove.com/v1/accounts/921483702001/videos?q=tags:wildlife&limit=2&offset=4