实现:分页

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