（6758期）Native Google Analytics – 直连 GA4 官方 API，掌控网站流量数据

直连 GA4 官方 API，掌控网站流量数据 直接调用 Google Analytics Data API 查询网站流量数据，无第三方代理，支持多维度自定义报表。 使用说明 核心用法 该技能通过 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 等常用维度。 显著优点 直连官方 API：无第三方数据中转，避免隐私泄露和额外服务依赖 灵活查询：支持多指标、多维度组合，自定义日期范围和路径过滤 Workspace 友好：内部应用模式跳过 Google 应用验证流程，配置简便 输出可控：默认可读表格，可管道输出原始 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 本身的账户权限限制 原始说明 Query Google Analytics 4 (GA4) data directly via the Analytics Data API. Use when you need website analytics like top pages, traffic sources, sessions, users...