實作:分頁

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

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

如果查詢有其他結果,API 回應就會包含 nextPageToken 屬性、prevPageToken 屬性,或兩者皆有。接著,您可以使用這些屬性的值設定 pageToken 參數,藉此擷取其他結果頁面。

舉例來說,以下查詢會擷取與「skateboarding dog」查詢相符的 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 參數值。