核心功能
Google Analytics 4 技能通过 analyticsdata.googleapis.com 官方 API 直连查询，无需第三方代理。支持获取页面浏览量、会话数、用户数、跳出率、转化率等核心指标，可按页面路径、流量来源、设备类型、地理位置等维度切片分析，并提供自定义日期范围与路径过滤功能。
显著优点
官方直连，数据权威：直接调用 Google Analytics Data API，数据实时性与准确性由 Google 保障，规避第三方爬取的数据延迟与采样偏差问题。
查询灵活度高：支持多指标组合（如同时查询 screenPageViews、sessions、totalUsers）、多维度交叉（如 sessionSource + sessionMedium），并可按日期范围、路径前缀等条件过滤，满足从概览到细分的多元分析需求。
零额外成本：依托 Google Cloud 免费配额，个人及小团队使用基本无费用压力。
潜在局限
配置门槛较高：需完成 Google Cloud 项目创建、OAuth consent 屏幕设置、API 启用、凭据生成及 refresh token 获取等 8 步流程，对非技术用户不够友好。analytics.readonly 属于敏感 scope，若使用个人 Gmail 需额外处理验证流程。
权限依赖严格：执行者 Google 账户必须拥有目标 GA4 属性的访问权限，否则直接返回 403 权限错误。
输出格式单一：默认仅输出格式化表格，需手动 piping 至 json.tool 获取结构化数据，不利于程序化下游处理。
适合人群
- 网站运营者、增长黑客需快速获取流量诊断数据
- 技术团队构建内部数据看板或自动化报告
- 市场营销人员追踪 Campaign 转化效果
常规风险
OAuth 令牌泄露风险：GOOGLE_REFRESH_TOKEN 长期有效，若环境变量管理不当，可能导致 GA4 数据被未授权访问。建议配合密钥管理服务使用。
数据隐私合规：GA4 数据可能包含用户地理位置、设备指纹等信息，分析时需遵循 GDPR、CCPA 等隐私法规要求。
Google 政策变更：Google 对 API 配额、敏感 scope 审核政策可能调整，需关注官方变更公告。