技能说明
Google 官方技能，适合 GA4 数据查询、运营报表和数据分析自动化。需要 gcloud、Application Default Credentials 与 analytics.readonly 权限；不负责账号配置或前端埋点安装。
关于此技能
Google 官方 Agent Skill，围绕 Google Analytics Data API 生成报表、查询指标与维度，并检查字段兼容性。
核心能力
API 与认证准备
启用 Analytics Data API，配置 Application Default Credentials 和只读访问范围。
自定义报表
按媒体资源、日期、城市、设备、事件等维度查询 activeUsers、sessions、revenue 等指标。
字段兼容性检查
在正式查询前检查指标与维度是否可以组合，减少 INVALID_ARGUMENT 错误。
可复用数据工作流
将报表查询接入仪表盘、定期分析和企业数据应用。
适用场景
生成 GA4 运营报表
按日期、城市、设备或页面等维度查询用户、会话、事件和收入。
自动化数据分析
把 Google Analytics 报表接入内部仪表盘或定期分析流程。
排查报表字段错误
遇到指标和维度不兼容时，先读取元数据并运行兼容性检查。
使用步骤
- 01
启用接口
通过 gcloud 启用 analyticsdata.googleapis.com，并确认 Cloud 项目权限。
- 02
准备授权
配置 Application Default Credentials，使用 cloud-platform 与 analytics.readonly 范围。
- 03
确认媒体资源
获取目标 GA4 property ID，明确查询时间范围、指标和维度。
- 04
检查兼容性
调用 getMetadata 或 checkCompatibility，确认字段组合可用。
- 05
运行并复核
使用官方客户端库生成 v1beta 报表，核对结果和查询边界。
常见问题
它和 Google Analytics 管理接口有什么区别？+
本技能负责报表数据查询；账号、媒体资源、数据流和配置管理应使用 Admin API 技能。
需要什么权限？+
通常需要 Cloud 项目权限、Application Default Credentials 和 analytics.readonly 访问范围。
能安装网站埋点吗？+
不能。它不负责网站或 App 的前端追踪安装，只读取已存在的 Analytics 数据。
为什么查询会报字段不兼容？+
某些指标和维度不能一起使用，应先读取元数据或调用 checkCompatibility 再生成报表。
安装前检查
把兼容性、来源和安装入口先看清楚，再放进自己的工作流。
Codex · Claude Code · Antigravity CLI
已提供来源链接
命令可直接复制
2026/08/24
安装提醒：这项技能可能涉及网络、脚本、文件或凭据权限，安装前请先阅读 SKILL.md，并确认它需要哪些权限。
npx skills add google/skills；安装时选择 skills/analytics/google-analytics-data-api-basics；Python 客户端可安装 google-analytics-data