以下範例說明如何擷取 YouTube Data API (v3) 查詢的其他結果組合。
API 會使用 maxResults
參數,指出 API 回應應包含多少項目。幾乎所有 API 的 list
方法 (videos.list
、playlists.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
參數值。