頁面搜索結果

在本主題中，您將學習如何實現分頁以實現以下結果： CMS API 請求，當請求匹配的項目超過您一次可以返回的數量時。這使您可以在較小的組中處理大型結果集，從而提高性能。單個請求最多返回100條記錄到 CMS API，但對於大型結果集，建議您為每個請求提取25個項目，以提高性能。

程序

要處理數據分頁，您將按照以下步驟操作：

首先，您需要知道結果集中的視頻總數。結果集中的響應會根據您的搜索條件而有所不同。使用 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
    }

要計算頁數，請取結果集中的記錄總數，然後除以每頁記錄數（頁面大小）。

您可以設置固定的頁面大小，或者如果要在網頁上顯示視頻數據，則可以讓用戶動態設置頁面大小（即每頁視頻數據對象的數量）。

JavaScript示例：

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

循環瀏覽您在上一步中計算出的頁數，然後調用 CMS API 與 limit 以及 offset 參數以檢索數據的連續子集。

本示例從結果集中的第10個視頻開始返回21個視頻。

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

您還可以包括可選 q 參數。有關將搜索條件與此參數一起使用的詳細信息，請參見使用 CMS API：搜索視頻文件。

該請求從標記結果為的視頻結果集中返回第2個視頻開始的5個視頻 野生動物.

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