关于切换至AdSense API version 2的升级流程相关咨询

前置准备 #

• 确认Google Cloud项目中已启用AdSense API v2，原有v1.4的启用状态、已申请的OAuth 2.0凭据无需重新生成，可直接复用

核心适配调整 #

1. 请求根路径替换 #

v1.4 旧版根路径：https://www.googleapis.com/adsense/v1.4/
v2 新版根路径：https://adsense.googleapis.com/v2/
所有接口请求的前缀统一替换为新版根路径即可。

2. 资源标识规则调整 #

v2所有资源采用统一的资源名格式，不再使用纯数字ID作为路径参数：

• 账户资源名格式为accounts/[原账户纯数字ID]，替代原有v1.4的accountId参数
• 广告客户端资源名格式为accounts/[原账户纯数字ID]/adclients/[原广告客户端ID]，替代原有v1.4的adClientId参数
• 广告单元资源名格式为accounts/[原账户纯数字ID]/adclients/[原广告客户端ID]/adunits/[原广告单元ID]，替代原有v1.4的adUnitId参数

3. 常用接口映射 #

• 账户列表查询：v1.4 GET /accounts → v2 GET /accounts，返回结果中取name字段作为后续接口的账户参数
• 收益数据生成：v1.4 GET /accounts/{accountId}/reports → v2 GET /accounts/{account}/reports:generate，原有startDate/endDate/metrics/dimensions核心参数逻辑基本不变，仅少量废弃指标可通过接口错误提示获取替代方案
• 广告单元列表查询：v1.4 GET /accounts/{accountId}/adclients/{adClientId}/adunits → v2 GET /accounts/{account}/adclients/{adClient}/adunits

常见报错处理 #

• 出现403 Permission denied：优先检查请求路径中的资源名格式是否正确，不要仅传入纯数字ID，其次确认OAuth凭据关联的账号具备目标AdSense账户的操作权限
• 出现404 Resource not found：检查请求根路径是否已经替换为v2专属地址，不要混用新旧版本的路径前缀
• 出现400 Invalid parameter：核对传入的指标、维度名称是否符合v2的命名规则，部分v1.4的旧参数已在v2中更名或废弃

内容的提问来源于stack exchange，提问作者찍신 - 영어의 모든 것