YouTube API单次调用获取频道全部视频maxResults返回数量异常问题
问题成因
YouTube Data API v3 的 search.list 接口对 maxResults 参数存在官方硬上限限制,该参数合法取值范围为0到50,就算传入大于50的数值,接口也会自动将参数值修正为50再返回结果,这就是你设置maxResults=111却只能拿到50条数据的核心原因,该限制无法通过修改单请求参数突破。
解决方法
要获取指定频道的全部公开视频,可选择以下两种方案:
方案一:基于
search.list接口分页拉取- 保持现有请求参数,将
maxResults调整为最大值50发起第一次请求,拿到第一页50条数据的同时,提取响应体中的nextPageToken字段值 - 后续每次请求都在原有参数基础上新增
pageToken参数,值为上一次请求返回的nextPageToken,每次请求最多可获取50条数据 - 重复发起请求直到响应中不再返回
nextPageToken,即已拉完该频道所有公开视频
注意:
search.list接口单请求会消耗100单位API配额,若频道视频量较大,配额消耗会很高,更推荐使用方案二。- 保持现有请求参数,将
方案二:使用
playlistItems.list接口拉取(更推荐)
该方案配额消耗极低,单请求仅消耗1单位配额,操作步骤如下:- 先调用
channels.list接口,请求参数设置为part=contentDetails&id={目标频道ID},从返回结果的contentDetails.relatedPlaylists.uploads字段,获取该频道的上传视频专属播放列表ID - 再调用
playlistItems.list接口,请求参数设置为part=snippet,contentDetails&playlistId={刚获取的上传列表ID}&maxResults=50,同样通过nextPageToken分页拉取,直到无nextPageToken返回即可拿到全量视频数据,整体效率远高于search.list方案。
- 先调用
内容的提问来源于stack exchange,提问作者Kamarat AbdelSalam
相关产品推荐
相关产品推荐

