以下示例展示了如何检索 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
参数值。