如何通过API将Google Analytics探索报表数据获取到本地？

一、Credentials.json中client_email字段的处理 #

• 无需手动修改该字段，它是在Google Cloud Console创建服务账号时自动生成的唯一标识。
• 你需要完成的关键操作是：将该client_email添加到Google Analytics 4的权限列表中：
  1. 进入GA4后台，点击左侧「管理员」选项
  2. 选择「账号权限」→「添加用户」
  3. 输入该client_email地址，分配「查看者」或「分析师」权限后保存
• Credentials.json中的所有字段均为自动生成，直接使用即可，不要随意修改。

二、最优实现方案推荐 #

根据你的需求场景，推荐以下几种方案：

1. GA4 Data API（自定义开发） #

适合需要灵活自定义维度/指标、自动化定时拉取数据的场景，也是你参考的Quick Start文档对应的方案。

• 步骤示例（Python）：
  1. 安装依赖：pip install google-analytics-data
  2. 编写代码拉取并保存数据：

     from google.analytics.data_v1beta import BetaAnalyticsDataClient
     from google.analytics.data_v1beta.types import RunReportRequest
     import csv
     
     # 初始化客户端
     client = BetaAnalyticsDataClient.from_service_account_json("credentials.json")
     
     # 构建报表请求（替换为你的属性ID、维度指标和时间范围）
     request = RunReportRequest(
         property="properties/123456789",
         date_ranges=[{"start_date": "7daysAgo", "end_date": "today"}],
         dimensions=[{"name": "city"}],
         metrics=[{"name": "activeUsers"}],
     )
     
     # 调用API获取数据
     response = client.run_report(request)
     
     # 保存为本地CSV
     with open("ga_report.csv", "w", newline="", encoding="utf-8") as f:
         writer = csv.writer(f)
         # 写入表头
         writer.writerow([dim.name for dim in request.dimensions] + [met.name for met in request.metrics])
         # 写入数据行
         for row in response.rows:
             writer.writerow([dim.value for dim in row.dimension_values] + [met.value for met in row.metric_values])
     

• 优势：高度灵活，可集成到现有自动化流程，支持复杂数据查询。

2. GA4计划报表导出（零代码） #

如果只需要定期获取你在Explore中创建的现有报表，无需自定义开发，直接用GA4内置功能即可：

• 操作步骤：打开目标Explore报表→右上角「分享」→选择「计划导出」→设置导出频率（日/周/月）、接收邮箱，GA4会自动将CSV文件发送到指定邮箱。
• 优势：操作简单，无需代码，适合非技术人员快速实现需求。

3. Google Apps Script（云端自动化） #

适合需要全自动化、无需本地运行代码的场景：

• 思路：创建Google Apps Script，通过服务账号认证调用GA4 API，将数据写入Google Sheets，设置定时触发器自动运行；之后可手动将Sheets导出为CSV，或通过脚本自动同步到Google Drive再拉取到本地。
• 优势：云端运行，无需维护本地环境，适合长期定时同步需求。

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