GAS调用GA4报表API遇端点错误，请求技术支持

核心问题 #

如何在Google Apps Script（GAS）中对GA4媒体资源运行报表？应使用AnalyticsData命名空间还是Analytics？或是媒体资源参数配置有误？

尝试的代码 #

report = AnalyticsAdmin.Properties.runReport(request,
        'properties/' + 'zxc');

Logger.log('We dont get here ' + report);

已参考相关Stack Overflow问题但无法解决。

脚本目标 #

每周自动从GA4获取访客数据并更新Google Sheets，步骤包括：

• 匹配GA账号与媒体资源
• 列出Web数据流
• 运行报表
• 更新表格

遇到的挑战 #

• 从旧版Google Analytics API迁移至新的Admin API和Data API
• 生成并执行API请求
• 调试权限与API方法调用问题

当前状态 #

脚本处于开发阶段，核心问题是运行报表时遇错误，无法获取数据。在GA Query Explorer中可得到有效JSON响应，但GAS中运行（含官方示例，仅修改Property ID）报错：

Execution log
1:29:32 PM  Notice  Execution started
1:29:33 PM  Info    Failed with error: undefined
1:29:32 PM  Notice  Execution completed

已添加AnalyticsData API命名空间至脚本，仍无法解决。

解决方案 #

1. 确认正确的API命名空间 #

GA4报表必须使用AnalyticsData命名空间，AnalyticsAdmin仅用于媒体资源的管理操作（如创建、修改属性），不负责报表查询。你的代码误用了AnalyticsAdmin.Properties.runReport，这是错误的方法。

2. 正确的报表调用方法 #

使用AnalyticsData.Properties.runReport，示例代码如下：

const propertyId = '你的GA4媒体资源数字ID';
const request = {
  dateRanges: [{ startDate: '7daysAgo', endDate: 'today' }],
  dimensions: [{ name: 'city' }],
  metrics: [{ name: 'activeUsers' }]
};

try {
  const response = AnalyticsData.Properties.runReport(request, `properties/${propertyId}`);
  Logger.log('报表响应：' + JSON.stringify(response));
} catch (e) {
  Logger.log('错误详情：' + e.message);
}

3. 排查常见错误点 #

• 媒体资源ID格式：确保使用纯数字ID（GA4资源ID通常以2XXXXXXX开头），不要用zxc这类占位符
• API启用状态：在Google Cloud平台确认已启用Google Analytics Data API（而非Admin API）
• 权限配置：运行脚本的账号需拥有GA4媒体资源的「查看者」或更高权限，且已完成GAS的OAuth授权流程
• 请求结构：保证request对象的dateRanges、dimensions、metrics字段符合GA4 Data API规范，可参照Query Explorer的参数结构调整

4. 调试优化 #

在代码中添加完整的错误捕获，打印详细错误信息，能快速定位具体问题（如权限不足、参数格式错误、API未启用等）。

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