核心用法
本技能通过 Maton 托管的 OAuth 网关，将 Google Analytics 的 Admin API 与 Data API 封装为统一的安全访问接口。开发者仅需一个 MATON_API_KEY 即可完成从账户管理到复杂报表查询的全流程操作，无需自行维护 OAuth 2.0 授权流程。
双 API 架构设计：
- Admin API (
google-analytics-admin)：管理账户结构、媒体资源（Properties）、数据流（Data Streams）、自定义维度与转化事件 - Data API (
google-analytics-data)：执行标准报表、实时报表与批量报表查询
典型工作流为：通过 accountSummaries 获取可访问的媒体资源列表 → 使用具体 propertyId 执行报表查询。支持 30daysAgo、today 等相对日期语法，以及 city、sessionSource、screenPageViews 等 GA4 标准维度和指标。
连接管理通过 ctrl.maton.ai 完成，需分别为两个 API 创建独立的 OAuth 连接。多连接场景可通过 Maton-Connection 头部指定具体连接实例。
显著优点
1. 零 OAuth 运维成本：Maton 托管 OAuth 令牌刷新与存储，开发者只需关注业务逻辑
2. 原生 API 透传：网关保留 Google 官方 API 的完整能力，包括 updateMask 局部更新、批量报表等高级特性
3. 多语言友好：提供 Python、JavaScript、Bash 等可直接运行的代码片段，降低接入门槛
4. 实时数据支持：通过 runRealtimeReport 端点获取分钟级活跃用户数据
5. 元数据自发现：调用 metadata 端点可动态获取当前 Property 支持的全部维度与指标列表
潜在缺点与局限性
1. 仅支持 GA4：Universal Analytics 已淘汰，历史 UA 数据无法通过本技能访问
2. 连接分离成本：Admin 与 Data API 需分别建立 OAuth 连接，管理复杂度略有增加
3. 网关依赖风险：所有流量经 gateway.maton.ai 代理，若 Maton 服务不可用则完全中断
4. 速率限制：10 req/sec 的账户级限速对高频实时场景可能构成瓶颈
5. 调试黑盒化：OAuth 错误（如令牌失效）需通过 Maton 控制台诊断，对排查效率有一定影响
适合人群
- 数据工程师：需要批量导出 GA4 数据至数仓（如每日自动化报表）
- 营销技术开发者：构建内部流量分析工具或客户数据平台（CDP）集成
- SaaS 产品经理：快速验证新功能对特定页面转化率的影响
- 小型创业团队：无专职 DevOps，希望跳过 OAuth 基础设施建设的场景
常规风险
- API Key 泄露：
MATON_API_KEY一旦泄露，攻击者可访问绑定的全部 GA 数据；建议存储于密钥管理系统，禁止硬编码 - 过度授权：OAuth 连接默认请求广泛的数据权限，应定期审计
ctrl.maton.ai中的活跃连接并删除无用授权 - 数据合规：通过第三方网关传输用户行为数据可能触发 GDPR/CCPA 的跨境传输条款，需确认 Maton 的数据处理协议（DPA）
- 报表采样：GA4 大数据量查询可能返回采样结果，关键决策应检查
samplesReadCounts字段确认数据完整性