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