用途：通过 Google Analytics Data API 查询 GA4 媒体资源的分析数据，支持按指标和维度拉取网站分析结果。
主要能力：可查询页面浏览量、会话、用户、新用户、活跃用户、跳出率、平均会话时长、转化、事件数等指标；可使用的维度包括 pagePath、pageTitle、landingPage、sessionSource、sessionMedium、sessionCampaignName、country、city、deviceCategory、browser、date 等。输出默认表格格式，也可用 --json 或 --csv 输出。
用法：需先一次性配置，启用 Google Analytics Data API，创建 OAuth 凭据或使用已有 Google Cloud 项目，并设置环境变量 GA4_PROPERTY_ID（数字型媒体资源 ID，如 "123456789"）、GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET、GOOGLE_REFRESH_TOKEN。随后运行脚本查询，例如：python3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --limit 30；多指标示例：python3 scripts/ga4_query.py --metrics screenPageViews,sessions,totalUsers --dimension pagePath --limit 20；流量来源：python3 scripts/ga4_query.py --metric sessions --dimension sessionSource --limit 20；落地页：python3 scripts/ga4_query.py --metric sessions --dimension landingPage --limit 30；自定义日期：python3 scripts/ga4_query.py --metric sessions --dimension pagePath --start 2026-01-01 --end 2026-01-15；按路径过滤：python3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --filter "pagePath=~/blog/"。
适用场景：需要将 GA4 数据接入自动化脚本、定期导出分析结果，或用命令行快速查看站点流量、来源与转化情况。
限制：需具备 GA4 媒体资源访问权限并完成 OAuth 授权；具体指标与维度组合是否可用取决于 API 规则，资料未提供完整指标与维度列表之外的更多细节。