Google Analytics三大API差异咨询：第三方站点数据报表需求

先明确三个API对应的GA产品体系，这是区分它们的核心：

1. Google Analytics API（Core Reporting API v3） #

• 对应体系：仅支持Universal Analytics（UA）（已停止新用户注册，现有账号将于2024年7月停止数据收集）
• 定位：UA最早的报表数据API，功能相对基础
• 限制：单次请求最多支持10个维度+10个指标，不支持复杂多段采样、批量请求等进阶功能
• 现状：官方已标记为「弃用」，仅保留维护性更新，不建议新项目使用

2. Google Analytics Reporting API v4 #

• 对应体系：仅支持Universal Analytics（UA）
• 定位：UA体系的进阶报表API，是Core Reporting API v3的替代版本
• 核心特性：
  • 支持复杂报表组合（多维度、多指标、多细分规则）
  • 支持批量请求、分段采样、自定义计算指标等高级功能
  • 提供更灵活的维度指标筛选、排序逻辑
• 适用场景：第三方客户仍在使用UA账号，且需要生成定制化复杂报表时，这是UA体系下的最优选择

3. Google Analytics Data API（GA4 Data API） #

• 对应体系：仅支持Google Analytics 4（GA4）（Google当前主推的新一代分析平台）
• 定位：GA4官方唯一的报表数据获取API
• 核心特性：
  • 适配GA4事件驱动的数据模型，支持获取事件、用户、会话等原生维度指标
  • 支持实时数据查询、高级细分、归因分析相关指标
  • 提供RunReport（标准报表）和RunPivotReport（透视表报表）两种查询模式，覆盖不同报表需求
• 适用场景：所有基于GA4账号的报表生成需求，是新项目首选，也是未来的主流方案

第三方站点/账号报表需求的选型建议 #

• 若客户使用GA4：直接采用Google Analytics Data API，这是唯一官方支持路径
• 若客户仍在使用UA：优先采用Google Analytics Reporting API v4，避免使用已弃用的Core Reporting API v3
• 注意：UA停止数据收集后，Reporting API v4也将逐步停止服务，建议尽早推动客户迁移至GA4并切换API

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