You need to enable JavaScript to run this app. 使用Service Account对接Google Ads API v6时触发HTTP401无效认证错误
优惠活动
大模型
产品
解决方案
定价
更多

使用Service Account对接Google Ads API v6时触发HTTP401无效认证错误

一、最高发的核心漏项:token生成逻辑缺少身份模拟参数

不管使用官方客户端库还是直接调用REST接口,只要token生成逻辑缺少subject身份模拟参数,所有环境下都会返回完全一致的401错误,这也是你切换客户端、切换测试环境问题依旧的核心原因。

开启域级委托的服务账号,必须在初始化鉴权客户端时显式指定要模拟的G Suite域内真实授权用户邮箱,否则生成的token是服务账号自身的原生身份凭证,未关联任何Google Ads体系内的客户访问权限,无法通过网关校验。

你当前的token生成代码存在核心缺失,修正后的参考实现:

const { google } = require('googleapis');
const getAccessToken = async () => {
    const SCOPES = ['https://www.googleapis.com/auth/adwords'];
    const authClient = new google.auth.GoogleAuth({
        keyFile: './pathtokeyfile.json',
        scopes: SCOPES,
        clientOptions: {
            // 替换为G Suite域内已在Google Ads账号中拥有管理员权限的真实用户邮箱
            subject: 'authorized-admin@your-g-suite-domain.com'
        }
    });
    const token = await authClient.getAccessToken();
    return token;
};

注意:没有subject参数时,即便你在G Suite后台为服务账号开通了对应scope的域委托权限,生成的token也无法通过Google Ads的鉴权校验。

二、次高发漏项:访问权限链路未完全打通

你需要完成两个层面的权限绑定,缺任意一环都会触发401:

  • 将模拟的真实G Suite用户邮箱,直接添加到Google Ads经理账号的用户列表中,权限设置为标准访问及以上
  • 如果你通过经理账号访问下属的广告客户账号,所有API请求必须补充login-customer-id请求头,值为10位的经理账号ID(移除ID中的横杠分隔符)

修正后的请求结构参考:

request({
  'method': 'GET',
  'url': 'https://googleads.googleapis.com/v16/customers/目标10位客户ID',
  'headers': {
    'Authorization': `Bearer ${生成的有效access token}`,
    'developer-token': '你的有效开发者令牌',
    'login-customer-id': '你的10位经理账号ID',
    'Content-Type': 'application/json'
  }
})

三、其他容易忽略的校验点

  • 确认G Suite后台为服务账号配置的域委托scope字符串完全匹配https://www.googleapis.com/auth/adwords,无多余空格、斜杠或拼写错误,否则委托权限不生效
  • 确认生成的access token没有过期,且scope范围完全匹配adwords授权要求,可通过Google提供的token校验接口传入token值,确认关联的身份是你设置的模拟用户,而非服务账号自身
  • 确认你使用的Google Ads API版本和当前调用的接口路径匹配,旧版v6接口已进入长期维护周期,部分鉴权规则和新版不兼容,建议升级到当前稳定版本的接口路径

内容的提问来源于stack exchange,提问作者Raymen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 20:54:04