核心用法
本技能通过 Maton 代理服务提供对 Google Analytics 4 (GA4) 的双 API 支持：
- Admin API：管理账户层级结构（accounts）、媒体资源（properties）、数据流（data streams）、自定义维度（custom dimensions）及转化事件（conversion events）
- Data API：执行标准报表查询（runReport）、实时数据报表（runRealtimeReport）及批量报表（batchRunReports）
认证采用 OAuth 2.0 托管模式，用户仅需在 Maton 平台创建连接并完成 Google 授权，后续所有请求通过 MATON_API_KEY 自动注入凭证，无需手动处理 token 刷新。
显著优点
1. 零 OAuth 维护成本：Maton 自动处理 token 生命周期管理，开发者只需关注业务查询
2. 双 API 统一入口：Admin 与 Data API 分别通过 /google-analytics-admin 和 /google-analytics-data 路径暴露，语义清晰
3. 丰富的查询能力：支持维度/指标组合、日期范围（相对/绝对）、排序、限制条数等完整 GA4 报表语法
4. 多语言示例完备：提供 Python、JavaScript、curl 的即 copy-paste 代码片段，降低接入门槛
潜在缺点与局限性
- 仅限 GA4：明确不支持已停用的 Universal Analytics 属性
- 双层连接管理：Admin 与 Data API 需分别创建
google-analytics-admin和google-analytics-data连接，增加配置复杂度 - 速率限制：每账户 10 req/sec，高频场景需本地缓存或批处理
- 代理依赖：所有流量经 Maton 中转，存在单点可用性风险及额外网络延迟
- 写入操作需确认：技能文档要求执行 create/update/delete 前必须人工确认，自动化场景受限
适合人群
- 需要程序化查询 GA4 数据的产品经理、数据分析师
- 构建内部数据面板、自动化周报系统的工程团队
- 希望避免自建 OAuth 基础设施的中小型开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据权限 | 连接授权后，Maton 服务端持有 Google Analytics 数据读取/管理权限，需信任 Maton 安全实践 |
| 密钥泄露 | `MATON_API_KEY` 泄露将导致账户级数据暴露，建议仅存放于环境变量或密钥管理服务 |
| 合规边界 | GA4 数据可能包含用户级行为信息，跨境传输需评估 GDPR/CCPA 合规要求 |
| 供应商锁定 | 深度依赖 Maton 代理路径，迁移至原生 Google API 需改写 URL 及认证逻辑 |