Google Analytics API调用遇Insufficient Permission错误，求权限配置方案

你遇到的这个403权限不足问题，大概率是核心Analytics API的配置或者授权环节有遗漏——虽然Embed API能正常工作，但它和你代码里调用的Analytics Management API是两个独立的服务，需要单独配置权限。以下是具体的排查和配置步骤：

1. 确保已启用Google Analytics API #

在Google Cloud Console中，你需要明确启用Google Analytics API（不是Embed API）：

• 进入Cloud Console的「API和服务」→「库」
• 搜索「Google Analytics API」，找到后点击「启用」按钮

Embed API的启用状态不影响核心Management API的调用，所以这一步是必须的。

2. 验证OAuth consent screen的权限范围 #

你的代码里已经添加了ANALYTICS_READONLY scope，但要确保这个权限已经在Cloud Console的OAuth同意屏幕中注册：

• 进入Cloud Console的「API和服务」→「OAuth同意屏幕」
• 在「Google API的权限」部分，添加https://www.googleapis.com/auth/analytics.readonly这个权限范围
• 如果是外部应用（非内部测试用），可能需要提交权限验证；测试阶段可以先添加测试用户，用测试账号授权

3. 确认授权账号的Analytics访问权限 #

你用来获取access token的Google账号，必须拥有目标Analytics账号的读取权限：

• 登录Google Analytics后台，进入「管理」→「账号」→「用户管理」
• 检查你的授权账号是否在用户列表中，并且角色至少是「查看者（Viewer）」

如果账号本身没有Analytics数据的访问权限，哪怕API配置正确，也会返回权限不足错误。

4. 重新获取有效的Access Token #

有时候缓存的access token可能没有包含正确的权限范围，建议：

• 清除会话中存储的$_SESSION["access_token"]
• 重新走一遍OAuth授权流程，确保新生成的token包含analytics.readonly权限
• 可以临时打印token的内容（比如print_r(json_decode($_SESSION["access_token"], true));），检查scope字段是否包含https://www.googleapis.com/auth/analytics.readonly

额外提示 #

Embed API的授权逻辑和核心Management API不同，它可能依赖Analytics的嵌入权限或者简化的授权流程，所以它能正常工作不代表核心API的配置没问题，必须单独完成上述配置步骤。

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