Google App Script调用OAuth2时access token返回Null问题

问题概述 #

• 依赖库适配异常：尝试使用通用GAS生态的第三方OAuth2库时，无论通过编辑器内置功能添加还是手动导入，调用均返回is not a function报错，无法正常使用。
• 令牌获取异常：使用Ads环境内置OAuth2库开发客户端模式认证逻辑时，后续接口返回500错误，排查发现accessToken值为null。

当前使用的调用代码如下：

function SHICall(){ 
  var tokenUrl = "X/token";
  const scriptProperties = PropertiesService.getScriptProperties();  
  var clientId = scriptProperties.getProperty('CLIENT_ID');
  var clientSecret = scriptProperties.getProperty('SECRET');
  var opt_scope = "CustomerAPI.Public";

  // Access token is obtained and cached.
  const authUrlFetch = OAuth2.withClientCredentials(tokenUrl, clientId, clientSecret, opt_scope);
  const url = "X";

  Logger.log(authUrlFetch);
  var options = { 
    headers: { 'Content-Type': "application/json", 'Accept': "application/json"},
    muteHttpExceptions: true,
    method: "GET",
    contentType: "application/json",
    validateHttpsCertificates: false,
  };

  // Use access token in each request
  const response = authUrlFetch.fetch(url, options);
  Logger.log(response);
}

问题原因与解决方法 #

1. 依赖库报错问题 #

两个OAuth库的适配问题本质是运行环境不兼容：

• Google Ads脚本环境内置了专属的OAuth2封装对象，仅支持在当前环境下调用
• 通用GAS生态的第三方OAuth2库适配的是独立Google App Script运行环境，无法在Ads脚本环境内加载，反复尝试导入没有意义，直接使用环境内置的OAuth2对象即可。

2. accessToken返回null的排查方向 #

按优先级从高到低排查：

• 基础参数校验
  • 替换tokenUrl占位符：必须填写目标服务提供的完整OAuth2令牌端点绝对URL，不能使用X/token这类相对路径或占位符。
  • 校验存储的密钥信息：添加日志打印clientId、clientSecret两个值，确认脚本属性中对应的key没有写错、值不为空，值前后不要带多余的空格、换行符。
  • 校验scope配置：确认传入的opt_scope值和目标服务文档要求的完全一致，大小写、标点不能有偏差；部分服务的scope为完整URI格式，而非短字符串；如果目标服务客户端模式不需要传scope，直接将该参数置为null即可。
• 请求格式适配
  Ads环境内置的OAuth2.withClientCredentials默认以application/x-www-form-urlencoded格式发起令牌请求，如果目标服务要求用JSON格式传参、或者要求特殊的认证头格式，内置封装会静默失败返回null。这种情况可以放弃内置封装，手动构造令牌请求，方便直接查看接口返回的错误信息：

  // 手动获取客户端模式令牌参考逻辑
  function getAccessToken() {
    const tokenUrl = "替换为完整的令牌端点URL";
    const { CLIENT_ID, SECRET } = PropertiesService.getScriptProperties().getProperties();
    const params = {
      method: "POST",
      muteHttpExceptions: true,
      // 按目标服务要求调整Content-Type和payload格式
      headers: {
        "Authorization": `Basic ${Utilities.base64Encode(`${CLIENT_ID}:${SECRET}`)}`
      },
      payload: {
        grant_type: "client_credentials",
        scope: "替换为实际需要的scope值"
      }
    };
    const res = UrlFetchApp.fetch(tokenUrl, params);
    // 打印原始返回，直接查看令牌接口报错原因
    Logger.log(res.getContentText());
    const { access_token } = JSON.parse(res.getContentText());
    return access_token;
  }
  

• 网络与权限校验
  • 去掉请求配置里的validateHttpsCertificates: false，如果目标服务HTTPS证书配置异常、或者当前脚本环境访问目标服务存在网络拦截，会导致令牌请求静默失败。可以先单独发起一个简单GET请求测试到令牌端点域名的连通性。
  • 确认使用的CLIENT_ID、SECRET已经在目标服务后台开通了对应scope的调用权限，部分服务需要手动提交接口权限申请，否则即使参数完全正确也不会返回有效令牌。

排查时优先查看令牌端点的原始返回内容，绝大多数令牌获取失败的问题，接口返回的错误信息会直接说明根因，比如密钥错误、scope不匹配、IP被拦截、账号权限不足等，不需要盲目猜测问题。

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