Google Analytics Core Reporting API 403权限错误排查与解决（无账号权限）

问题详情 #

此前稳定使用Google Analytics Core Reporting API（端点：https://www.googleapis.com/analytics/v3/data/ga），近期突然返回403错误，具体提示：

User does not have sufficient permissions for this profile

已执行的排查操作 #

• 确认API请求配置、参数无任何变更
• 尝试通过Management API和Admin API排查权限问题，未发现有效线索
• 发现原用于核心报告的ViewID在账号摘要中已缺失（注：ViewID对应配置文件ID，账号摘要默认显示账号ID）
• 切换至Google Analytics Reporting API v4后，相同403错误仍存在

背景信息 #

• 无该Google Analytics账号的直接访问权限
• API此前运行完全正常

关联代码片段 #

url = 'https://accounts.google.com/o/oauth2/token'
headers = {
    'Authorization': token
}

payload = {
    'client_id': 'x',
    'client_secret': 'x',
    'refresh_token': 'x',
    'grant_type': 'refresh_token'
}

response = requests.post(url, headers=headers, json=payload)

token = f"{response_obj['token_type']} {response_obj['access_token']}"

# 发起GA数据请求
url = 'https://www.googleapis.com/analytics/v3/data/ga'

headers = {
    'Authorization': f"{token}"
}

params = {
    'ids': 'ga:227x',
    'metrics': '{x}', ...
}

response = requests.get(url, headers=headers, params=params)

解决步骤与分析 #

1. ViewID缺失是核心原因 #

你观察到的ViewID缺失直接导致了权限错误：

• ga:227x对应的View（视图）已被账号管理员删除，或该View的权限配置被修改
• API请求必须指定有效的ViewID，一旦View不存在或授权身份无访问权限，就会返回403权限不足错误

2. 无直接账号权限下的处理方案 #

• 联系账号管理员执行以下操作：
  • 确认ga:227x对应的View状态：是否被删除、权限是否调整
  • 若View已删除：请求创建新的View，并获取新的ViewID替换请求参数中的ids值
  • 若View存在：请求为你的OAuth授权身份（服务账号/关联用户）授予该View的Read & Analyze权限
• 验证授权令牌有效性：
  • 检查刷新令牌是否被管理员吊销，重新发起令牌请求确认access_token是否有效
  • 确认client_id、client_secret、refresh_token未被修改或失效

3. 额外排查项 #

• 请管理员确认Google Cloud控制台中，Analytics API（v3和v4）是否处于启用状态
• 排查API调用配额是否耗尽（配额不足通常会返回特定配额错误，但可作为补充验证点）

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