以下示例展示了如何检索 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 个匹配项,以及一个 nextPageToken
属性,可用于检索接下来的 10 个结果:
以下查询会检索查询的下 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
参数值。