有效令牌下Youtube Analytics API仍返回403 Forbidden问题排查

先还原下你的问题场景，方便大家理解：

你在对接YouTube频道的Analytics API时，已经通过youtube.readonly和yt-analytics.readonly两个scope完成了OAuth2授权，token和refresh token存在数据库里。初期一切正常，但过了1-6个月后，部分频道（约40%）突然出现403 Forbidden错误，同一token调用YouTube Data API却完全正常，而且频道所有者并没有撤销授权或修改密码。

你用的是google-api-python-client 1.6.5，授权和请求代码如下：

授权URL生成代码 #

flow = client.flow_from_clientsecrets(
    secret_file_path,
    scope=["https://www.googleapis.com/auth/youtube.readonly", "https://www.googleapis.com/auth/yt-analytics.readonly"],
    redirect_uri=redirect_url,
    prompt="consent"
)
flow.params["access_type"] = "offline"
url = flow.step1_get_authorize_url(state=state)

Analytics请求代码 #

auth = client.OAuth2Credentials.from_json(credentials_from_db)
http_auth = auth.authorize(httplib2.Http())
api = discovery.build("youtubeAnalytics", "v1", http=http_auth, cache_discovery=False)
api.reports().query(
    ids="channel==%s" % channel_id,
    metrics="estimatedMinutesWatched",
    dimensions="video",
    start_date=start_date,
    end_date=end_date,
    max_results=20,
    filters="video=={}".format(",".join(video_ids))
).execute(http=http)

补充调试信息：两次请求（Data API和Analytics API）都成功刷新了token，但只有Data API能正常返回结果，单独调用Analytics API也是一样的403，且代码会正常运行数月后突然失效。

可能的原因及针对性解决方案 #

1. 老旧API客户端库的兼容性问题 #

你用的google-api-python-client 1.6.5是2018年的版本，实在太老了。Google的OAuth2机制和API端点这些年更新了很多，旧库可能存在token刷新逻辑漏洞、请求签名不兼容新校验规则等问题，导致一段时间后Analytics API的请求被拒绝，但Data API的校验相对宽松所以能正常工作。

解决办法：
立刻升级到最新版的客户端库，同时建议迁移到Google推荐的新认证栈（因为oauth2client已经被弃用了）：

pip install --upgrade google-api-python-client google-auth google-auth-oauthlib google-auth-httplib2

升级后调整代码，比如用google_auth_oauthlib.flow.Flow替代旧的client.flow_from_clientsecrets，用google.oauth2.credentials.Credentials替代OAuth2Credentials，这能解决很多潜在的token刷新和请求兼容性问题。

2. YouTube Analytics API的特殊资格要求 #

Analytics API的部分核心数据（比如你请求的estimatedMinutesWatched）需要频道满足YouTube Partner Program (YPP) 条件，或者已经关联了AdSense账号。如果某个频道在授权后失去了YPP资格（比如订阅数跌破门槛、违反社区规则），或者AdSense关联被取消，那么即使token有效，Analytics API也会返回403，但Data API的基础数据不受影响。

解决办法：

• 在请求Analytics API前，先通过Data API的channels.list接口检查频道状态，比如查看statistics字段是否正常，或者提示用户去YouTube Studio确认自己的频道是否还符合YPP要求。
• 在应用中增加错误处理，当收到403时，明确告知用户可能是频道资格问题，引导他们自查。

3. Google的Refresh Token自动回收机制 #

Google会在几种情况下自动撤销refresh token，哪怕用户没手动操作：

• 用户账号启用了高级保护程序，这类账号的refresh token有效期更短，且会被自动轮换。
• Google检测到token被用于异常IP/设备（比如你的服务器IP变动，或者token意外泄露）。
• 同一应用对同一用户生成的refresh token超过50个上限，旧的会被自动撤销（如果你的应用每次用户重新授权都生成新token却不清理旧的，就会触发这个问题）。

解决办法：

• 检查你的数据库，确保每个用户只保留最新的一个refresh token，避免超过上限。
• 在token刷新时捕获RefreshError异常，一旦发现refresh token失效，立即引导用户重新授权。
• 如果用户用的是高级保护账号，提前告知他们需要更频繁地重新授权。

4. 请求参数的潜在问题 #

你的请求里用了字符串拼接生成filters和ids参数，可能存在编码问题，或者某个视频被删除/设为私有，导致整个请求被拒绝。

解决办法：

• 在构建filters前，先通过Data API的videos.list接口验证每个video_id的有效性（是否存在、是否可访问）。
• 使用f-string或参数绑定方式传递参数，避免手动拼接的编码问题：

api.reports().query(
    ids=f"channel=={channel_id}",
    metrics="estimatedMinutesWatched",
    dimensions="video",
    start_date=start_date,
    end_date=end_date,
    max_results=20,
    filters=f"video=={','.join(video_ids)}"
).execute()

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