调用Youtube commentThreads接口遇HttpError 400，请求参数存疑

问题重现 #

调用youtube.commentThreads().list接口时，指定part="id,replies,snippet"和channelId参数触发400 HttpError，错误提示要求检查请求体的commentThread结构，但该请求为GET请求无请求体；替换为allThreadsRelatedToChannelId参数则返回200正常响应。已启用YouTube Data API，权限范围设置为youtube.force-ssl。

调试代码片段：

# 报错的请求
request = self.service.commentThreads().list(part="id,replies,snippet", channelId="UCxz_B5DVTdZV5c0JLctjqUA")
request.execute()
# 返回：googleapiclient.errors.HttpError: <HttpError 400 ... 提示检查请求体结构>

# 正常的请求
request=self.service.commentThreads().list(part="id,replies,snippet", allThreadsRelatedToChannelId="UCxz_B5DVTdZV5c0JLctjqUA")
request.execute()
# 返回200响应

原因分析 #

1. 参数语义不匹配：
   • channelId参数用于检索指定频道发布的视频下的评论线程，并非该频道账号在其他视频中发布的评论。你的需求是获取自己账号在其他视频的评论，allThreadsRelatedToChannelId才是匹配需求的正确参数。
2. API错误提示不准确：
   400错误提示指向请求体，但实际是API对channelId参数的内部校验异常——可能是当目标频道无公开可评论视频，或API临时处理逻辑故障时，返回了错误的提示信息，而非请求体真存在结构问题。

解决方案 #

1. 使用正确参数：
   继续使用allThreadsRelatedToChannelId参数，该参数专门用于获取指定频道账号在所有视频（包括其他频道视频）下发布的评论线程，完全匹配你的需求。
2. 若需使用channelId参数的修复尝试：
   如果确实需要获取自己频道视频的评论，可尝试添加maxResults参数（如maxResults=10），或确认目标频道存在公开的可评论视频，部分情况下API会因无数据返回而抛出错误。

补充说明 #

• 权限方面，youtube.force-ssl权限范围足够支持两个参数的调用，无需额外配置其他权限。
• 若Google官方文档中的channelId示例也无法运行，大概率是API临时故障或文档未及时更新，此时优先使用allThreadsRelatedToChannelId作为替代方案。

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