實作:分頁

以下範例說明如何擷取 YouTube Data API (v3) 查詢的其他結果組合。

API 會使用 maxResults 參數來指出 API 回應中應包含多少項目。幾乎所有 API 的 list 方法(videos.listplaylists.list 等)都支持它。

如果查詢有其他結果,API 回應會包含 nextPageToken 屬性和 prevPageToken 屬性,或是同時包含兩者。這些屬性的值可用於設定 pageToken 參數來擷取額外的搜尋結果頁面。

舉例來說,以下查詢會擷取與查詢「滑板狗狗」相關的最多 10 部影片的搜尋結果:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &q=skateboarding+dog
        &type=video

API 回應包含查詢的前 10 個相符項目,以及可用於擷取後 10 個結果的 nextPageToken 屬性:

以下查詢會擷取查詢的未來 10 項結果:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &pageToken=CAoQAA
        &q=skateboarding+dog
        &type=video

注意:您可能需要更新 pageToken 參數的值,才能在 API Explorer 中完成這項要求。執行會擷取前 10 筆結果的查詢,以取得正確的 pageToken 參數值。