通过 Google Analytics Data API 只读查询 GA4 数据，支持页面流量、用户行为、转化追踪等多维度分析，需 OAuth 环境变量配置。
说明：
## 核心用法
GA4 技能是连接 Google Analytics 4 的官方数据查询工具，基于 Analytics Data API v1 构建。用户通过环境变量配置 OAuth 凭证后，可执行只读查询获取网站分析数据，包括页面浏览量、会话数、用户数、流量来源、转化率等核心指标。
### 显著优点
1. **官方 API 集成**：直接对接 Google 官方 Analytics Data API，数据准确性与实时性有保障
2. **只读安全设计**：明确限定为读取权限，无法修改 GA4 属性配置或数据
3. **灵活查询能力**：支持多指标/维度组合、自定义日期范围、正则过滤、多种输出格式（表格/JSON/CSV）
4. **开箱即用示例**：提供覆盖常见场景（热门页面、流量来源、着陆页等）的现成命令模板
### 潜在局限
– **配置门槛**：需预先完成 Google Cloud 项目设置、API 启用、OAuth 授权流程，对非技术用户不够友好
– **凭证管理风险**：依赖四个环境变量（含 client_secret 和 refresh_token），若配置不当存在凭证泄露隐患
– **仅限 GA4**：不支持 Universal Analytics（已停止服务），历史 UA 数据需迁移
– **无可视化**：纯 CLI/文本输出，需配合其他工具做数据可视化
### 适合人群
– 网站运营人员、增长黑客、数据分析师
– 需要将 GA4 数据集成到自动化报告或数据管道的技术团队
– 熟悉 OAuth 流程、具备基础 Python 环境的开发者
### 常规风险
– OAuth refresh_token 长期有效，需妥善保管环境变量
– 查询范围受 GA4 账号权限限制，无法越权访问未授权属性
– 频繁 API 调用可能触及 Google 配额限制（每日 200,000 次请求）
