支持 聯繫支持 | 系統狀況 系統狀態

頁面搜索結果

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

計算頁面

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

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

JavaScript示例:

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

檢索頁面

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

本示例從結果集中的第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

頁面最後更新於12年2020月XNUMX日