核心用法
Google Analytics Skill 提供了一套完整的 GA4 数据接入方案，涵盖 Admin API 与 Data API 两大核心能力。Admin API 用于管理账户层级结构，包括查询账户摘要、创建/管理属性（Property）、配置数据流（Data Stream）、设置自定义维度与转化事件等配置型操作。Data API 则专注于数据查询，支持运行标准报表、实时报表及批量报表，可获取活跃用户、会话数、页面浏览量、跳出率、转化次数等关键指标。
用户需先在 Maton 平台完成 OAuth 授权，建立 google-analytics-admin 与 google-analytics-data 两个独立连接（因两 API 权限分离）。随后通过统一的 Gateway 代理地址发起请求，系统自动注入 OAuth Token，开发者仅需关注业务查询本身。
显著优点
1. 零鉴权负担：托管 OAuth 模式免除了开发者自行维护 Google Cloud 项目、处理 OAuth 2.0 流程及 Token 刷新的复杂性。
2. 双 API 覆盖：同时支持配置管理（Admin）与数据消费（Data），满足从初始化部署到日常分析的完整生命周期需求。
3. 实时数据能力：内置 runRealtimeReport 接口，可获取当前在线用户、活跃会话等实时指标，适用于监控大屏与告警场景。
4. 灵活查询语法：支持相对日期（30daysAgo/today）、多维度多指标组合、排序与分页，且可通过元数据接口动态发现可用字段。
潜在局限与风险
- GA4 独占：明确不支持已废弃的 Universal Analytics（UA），历史 UA 数据需迁移或另寻方案。
- 连接分离设计：Admin 与 Data API 需分别建立 OAuth 连接，增加了初期配置步骤，若遗漏会导致 400 错误。
- 速率限制：平台级限流 10 req/sec/account，高并发报表场景需考虑缓存或批量查询策略。
- 数据隐私合规：通过第三方代理（Maton）转发至 Google，需评估 GDPR/CCPA 等合规要求及数据跨境传输条款。
- 环境变量陷阱：文档特别指出，curl 管道至
jq时可能出现环境变量未展开问题，导致"Invalid API key"错误。
适合人群
- 需要快速集成 GA4 数据但不愿投入 OAuth 工程成本的中小团队
- 构建内部数据分析看板、营销自动化工作流的产品开发者
- 已有 Maton 生态使用基础，希望统一 API 网关管理多数据源的企业用户
安全与可信度评估
来源为 Maton 官方维护（T2），采用标准 OAuth 2.0 授权码模式，Token 由平台托管而非暴露给终端用户。但需注意：所有流量经 Maton 网关代理，存在中间人视角的数据可见性；建议敏感业务评估自托管方案或加强审计日志监控。综合评定安全等级 A。