使用Google Apps Script OAuth2库连接GA API遇权限范围不足错误

嘿，这个错误我太熟了——本质就是你当前的OAuth2服务没有请求访问Google Analytics相关API所需的权限范围。Google的每个API都有特定的权限要求，必须在创建OAuth服务时明确指定才行。咱们一步步来搞定：

1. 先搞清楚需要的权限范围 #

根据你用的API，对应的必填scope是这些：

• 不管是Google Analytics Reporting API v4（对应旧版UA）还是Google Analytics Data API v1（对应GA4），只读权限的scope都是 https://www.googleapis.com/auth/analytics.readonly——这个是大多数场景下的最优选择，足够获取数据，又不会过度授权。
• 如果确实需要修改GA设置的权限，用 https://www.googleapis.com/auth/analytics，但一般只读就够了。

2. 给你的OAuth2服务加上权限范围 #

你需要在getService_()函数里添加.setScope()方法，把需要的scope传进去。修改后的函数大概是这样（记得替换你自己的客户端ID和密钥）：

function getService_() {
  return OAuth2.createService('GService')
    .setAuthorizationBaseUrl('https://accounts.google.com/o/oauth2/auth')
    .setTokenUrl('https://accounts.google.com/o/oauth2/token')
    .setClientId('你的客户端ID')
    .setClientSecret('你的客户端密钥')
    .setScope('https://www.googleapis.com/auth/analytics.readonly') // 关键：添加这一行
    .setCallbackFunction('authCallback') // 你的回调函数，应该已经定义过了
    .setPropertyStore(PropertiesService.getUserProperties()); // 存储token的位置
}

3. 重置旧的授权（很重要！） #

因为你之前已经授权过一次，旧的权限范围会被缓存下来，所以必须重置授权才能让新的scope生效：

• 打开你的Apps Script项目，直接运行getService_()函数；
• 这时会弹出新的授权请求，里面会显示新增的GA访问权限，确认授权就行；
• 要是没弹出，你可以去Google账号的安全设置里找到这个应用，手动撤销授权，再重新运行脚本触发授权。

4. 验证API调用是否正常 #

这里给你一个调用GA Reporting API的示例代码，确保你的请求正确使用了OAuth2的token：

function fetchAnalyticsSessions() {
  const service = getService_();
  // 先检查是否已授权
  if (!service.hasAccess()) {
    const authUrl = service.getAuthorizationUrl();
    Logger.log('请访问这个URL完成授权：%s', authUrl);
    return;
  }

  // 构造GA Reporting API的请求
  const apiUrl = 'https://analyticsreporting.googleapis.com/v4/reports:batchGet';
  const requestPayload = {
    reportRequests: [
      {
        viewId: '你的GA视图ID', // 替换成你自己的视图ID
        dateRanges: [{startDate: '7daysAgo', endDate: 'today'}],
        metrics: [{expression: 'ga:sessions'}]
      }
    ]
  };

  const fetchOptions = {
    method: 'post',
    contentType: 'application/json',
    headers: {
      Authorization: 'Bearer ' + service.getAccessToken() // 用OAuth2获取的token
    },
    payload: JSON.stringify(requestPayload)
  };

  const response = UrlFetchApp.fetch(apiUrl, fetchOptions);
  Logger.log('GA数据：%s', response.getContentText());
}

几个要注意的小细节 #

• 确保你的Google账号本身有权限访问目标GA媒体资源（比如是该GA账号的查看者或编辑者）；
• 如果是用GA4，记得用对应的Google Analytics Data API v1的endpoint，而不是UA的Reporting API；
• 尽量用只读权限，不要请求不必要的高权限，更安全。

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