核心用法
该技能通过 Python 脚本调用 analyticsdata.googleapis.com，实现对 GA4（Google Analytics 4）属性的原生数据查询。用户需完成一次性 OAuth 2.0 配置，包括创建 Google Cloud 项目、启用 Analytics Data API、设置 OAuth 内部应用（推荐 Workspace 账户）、添加 analytics.readonly 敏感权限范围，并生成长期有效的 Refresh Token。
运行查询时，脚本接收 --metrics、--dimension、--start/--end 日期范围、--filter 过滤条件等参数，返回格式化的流量数据表格，支持 screenPageViews、sessions、conversions、bounceRate 等核心指标，以及 pagePath、sessionSource、deviceCategory 等常用维度。
显著优点
1. 直连官方 API：无第三方数据中转，避免隐私泄露和额外服务依赖
2. 灵活查询：支持多指标、多维度组合，自定义日期范围和路径过滤
3. Workspace 友好：内部应用模式跳过 Google 应用验证流程，配置简便
4. 输出可控：默认可读表格，可管道输出原始 JSON 便于二次处理
潜在缺点与局限性
- 配置门槛高：需熟悉 GCP 项目创建、OAuth 流程、权限管理，非技术用户上手困难
- Workspace 账户限制："Internal" 应用类型强制要求 Google Workspace 账户，个人 Gmail 需走 External 验证流程
- Token 管理负担：Refresh Token 可能因账户安全策略失效，需手动重新生成
- 无可视化层：纯命令行输出，需配合其他工具做图表展示
- 敏感权限：
analytics.readonly属于 Google 定义的敏感范围，虽为只读仍需严格保管凭据
适合人群
- 网站运营、产品经理、数据分析师等技术背景用户
- 已使用 Google Workspace 的企业团队
- 需要自动化报表、定时拉取 GA4 数据的开发者
- 对数据隐私敏感、拒绝第三方 SaaS 中转的用户
常规风险
- 凭据泄露风险：Client ID/Secret 和 Refresh Token 若被窃取，攻击者可读取关联 GA4 的全部数据
- 权限配置错误：遗漏
analytics.readonly范围或账户无 GA4 访问权会导致 403 错误 - Token 过期：长期未使用或 Google 安全策略变更可能导致 Refresh Token 失效
- 数据权限边界：脚本以授权用户身份访问，无法突破 GA4 本身的账户权限限制