YouTube Search.list接口搜索频道时totalResults有值但items为空问题

异常特征 #

调用接口设置type=channel搜索频道时的典型异常，返回报文如下：

{
  "kind": "youtube#searchListResponse",
  "etag": "iHuEFDsu11n1f_tDVzZYHXDlOIQ",
  "regionCode": "IL",
  "pageInfo": {
    "totalResults": 4,
    "resultsPerPage": 0
  },
  "items": []
}

排查与修复步骤 #

• 检查maxResults请求参数：该参数默认值为5，有效值范围是0_{50，如果你误将该参数设置为0，接口会统计符合条件的总结果数，但不会返回具体条目，直接将参数修改为1}50之间的整数即可解决绝大多数此类问题。
• 检查区域限制规则：返回报文中的regionCode为IL（以色列），匹配到的4个频道可能均未对以色列区域开放内容展示权限，你可以尝试移除regionCode参数，或者将参数修改为频道目标受众所在的区域再重试。
• 检查API权限与配额：确认你的请求使用的API密钥所属Google Cloud项目已经开启YouTube Data API v3权限，且当前配额没有耗尽，配额不足时接口可能出现总计数正常但返回条目为空的异常。
• 清理无效过滤参数：如果你同时传入了videoDuration、videoDefinition等仅对视频搜索生效的过滤参数，会导致匹配到的频道条目被过滤、仅保留总计数，移除这类不相关的过滤参数即可。

内容的提问来源于stack exchange，提问作者Wissotsky