核心用法
本技能提供 Google Analytics 的双 API 集成能力,通过 Maton 网关代理实现托管式 OAuth 认证:
Admin API —— 用于管理 GA4 账户结构:
- 查询账户列表、属性(Properties)、数据流(Data Streams)
- 创建/更新属性、自定义维度、转化事件
- 典型端点:
/accountSummaries、/properties、/dataStreams
Data API —— 用于运行分析报告:
runReport:标准历史数据报告runRealtimeReport:实时活跃用户数据batchRunReports:批量多请求查询
所有请求通过 gateway.maton.ai 代理,自动注入 OAuth Token,开发者仅需提供 Maton API Key。
显著优点
1. 零 OAuth 开发成本:无需实现 Google OAuth 2.0 授权码流程,Maton 托管连接生命周期
2. 双 API 统一入口:Admin 与 Data API 共享同一认证体系,分别通过 -admin 和 -data 子域名访问
3. 原生 API 透传:保留 Google Analytics API 的原生路径和请求格式,学习成本低
4. 灵活的连接管理:支持多 Google 账户切换,通过 Maton-Connection 头指定特定连接
潜在局限
1. 仅限 GA4:不支持已废弃的 Universal Analytics
2. 依赖第三方网关:所有流量经 Maton 中转,存在单点依赖
3. 双连接配置:Admin API 和 Data API 需分别创建 OAuth 连接,增加初次配置步骤
4. 速率限制:10 req/sec 每账户,高频场景需自行缓存
适合人群
- 需要快速集成 GA4 数据的产品团队
- 不愿维护 OAuth 令牌刷新逻辑的后端开发者
- 需同时管理账户配置和查询报告的运营/数据分析师
常规风险
- 数据隐私:网站流量数据经第三方网关,需评估 Maton 的数据处理条款
- 连接失效:OAuth 授权可能因用户撤销或 Google 策略变更而失效,需监控连接状态
- API 兼容性:Google Analytics API 版本更新(v1beta → v1)时需关注网关适配