核心用法
本技能提供Google Analytics API的双向集成能力，分为两大核心模块：
Admin API —— 账户资产管理
- 查询账户摘要、属性列表和数据流配置
- 创建/修改GA4属性、Web数据流、自定义维度和转化事件
- 典型场景：自动化配置多站点跟踪、批量设置转化目标
Data API —— 数据报表分析
- 运行标准报表（runReport）、实时报表（runRealtimeReport）和批量报表（batchRunReports）
- 支持灵活维度组合（城市、页面路径、流量来源等）与指标查询（活跃用户、会话数、转化率等）
- 日期范围支持相对表达式（
7daysAgo、today）和绝对日期
所有请求通过Maton网关代理，自动注入OAuth令牌，开发者仅需管理单一API密钥。
显著优点
1. 零OAuth开发成本：托管OAuth免去Google Cloud项目配置、令牌刷新和权限范围管理的繁琐工作
2. 双API统一入口：Admin与Data API共用认证体系，降低多系统集成复杂度
3. 实时数据能力：runRealtimeReport支持分钟级活跃用户监控，适用于运营 dashboards
4. 元数据自发现：metadata端点动态获取可用维度/指标列表，避免硬编码
5. 代码示例完备：覆盖cURL、JavaScript、Python，开发上手周期短
潜在缺点与局限性
- 仅支持GA4：Universal Analytics完全弃用，历史UA数据无法通过本技能查询
- 速率限制：10 req/sec/账户，高频实时场景需客户端缓存或批处理优化
- 属性ID格式敏感：必须使用
properties/数字ID完整格式，易因格式错误导致404 - 双连接管理负担：Admin与Data API需分别建立OAuth连接，多账户场景连接数翻倍
- 错误透传延迟：Google侧4xx/5xx错误原样返回，调试时需区分网关层与Google层问题
- 数据延迟：标准报表非实时，T+1至T+24小时延迟，强实时需求需配合Realtime API
适合人群
- 需要快速集成GA4数据的产品团队（替代自建ETL）
- 运营/增长团队构建自动化数据看板（结合Low-code工具）
- 多租户SaaS厂商为租户提供嵌入式分析（需自行处理数据隔离）
常规风险
- OAuth授权范围过度：默认授权可能包含账户管理权限，建议定期审计ctrl.maton.ai的连接权限
- API密钥泄露：MATON_API_KEY一旦泄露，攻击者可访问全部绑定的GA账户数据，需严格环境变量隔离
- 数据合规边界：用户数据导出需符合GDPR/CCPA，技能本身不提供数据脱敏或匿名化机制
- 供应商锁定：深度依赖Maton网关后，迁移至原生Google API需重构认证层