如何在Node.js中调用Google Analytics GA4报告API获取统计报告

1. 前期准备 #

• 登录Google Cloud Console，创建项目后启用Google Analytics Data API v1
• 创建服务账号，生成并下载JSON格式的密钥文件
• 在GA4媒体资源后台，将该服务账号添加为查看者角色，确保其有权访问统计数据

2. 安装依赖 #

执行npm命令安装官方SDK：

npm install @google-analytics/data

3. 核心实现代码 #

创建ga4-report.js文件，写入以下代码：

const { BetaAnalyticsDataClient } = require('@google-analytics/data');

// 初始化客户端，替换为你的密钥文件路径
const analyticsDataClient = new BetaAnalyticsDataClient({
  keyFilename: './service-account-key.json'
});

// 异步获取报告数据
async function fetchGA4Report() {
  try {
    const [response] = await analyticsDataClient.runReport({
      // 替换为你的GA4媒体资源ID（格式：properties/[资源ID]）
      property: 'properties/123456789',
      dateRanges: [
        {
          startDate: '7daysAgo',
          endDate: 'today'
        }
      ],
      // 自定义维度，可根据需求添加
      dimensions: [
        { name: 'city' },
        { name: 'deviceCategory' }
      ],
      // 自定义指标，可根据需求添加
      metrics: [
        { name: 'activeUsers' },
        { name: 'screenPageViews' }
      ]
    });

    // 格式化输出结果
    console.log('GA4统计报告：');
    console.log('维度\t\t\t指标');
    response.rows.forEach(row => {
      const dims = row.dimensionValues.map(val => val.value).join('\t\t');
      const mets = row.metricValues.map(val => val.value).join('\t\t');
      console.log(`${dims}\t\t${mets}`);
    });
  } catch (error) {
    console.error('获取报告失败：', error.message);
  }
}

// 执行报告获取
fetchGA4Report();

4. 参数说明 #

• property：GA4媒体资源ID，可在GA4后台「管理」->「媒体资源设置」中找到
• dateRanges：支持相对日期（如7daysAgo、yesterday）或绝对日期（YYYY-MM-DD）
• dimensions：可选维度，比如date、country、operatingSystem等
• metrics：可选指标，比如newUsers、sessions、averageSessionDuration等

5. 运行代码 #

在终端执行以下命令即可获取统计数据：

node ga4-report.js

内容的提问来源于stack exchange，提问作者Madhukar.j Madhu