1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | google-analytics-data-api-basics-google-skills |
| 作者/维护者 | Google（仓库账号 google，维护团队内部代号 Cloud IX Team） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/analytics/google-analytics-data-api-basics |
| 许可证 | Apache-2.0（GitHub API 确认） |
| GitHub Stars / Forks | 15,235 / 1,192（GitHub API 实测；该数字为仓库整体，本技能所在子目录不单独统计 star，仅作背景参考） |
| 最新版本 | 无正式 Release/Tag，滚动更新；本技能所在子目录最近一次实质性提交为 2026-07-24 |
| 安装方式 | npx skills add google/skills，安装时从交互列表勾选本技能 |
2. 功能介绍与亮点
google-analytics-data-api-basics 是 Google 官方维护的 Google Analytics（GA4）报表数据查询技能，指导编码助手通过 Data API（v1beta）启用接口、完成认证、构建报表查询，把网站流量、用户行为、转化收入等指标程序化取出，用于搭建自定义仪表盘或自动化报表流程。
主要亮点：
- 七种语言客户端库参考文档：除主 SKILL.md 外，
references/目录下为 Python、Java、PHP、Node.js、Go、.NET、Ruby 各配一份独立安装指南，涵盖包名、Artifact 坐标等具体细节，而非仅罗列语言名称。 - 完整可运行示例：正文给出按城市、日期分组查询活跃用户数与会话数的 Python 完整代码，可直接复制运行，而非伪代码片段。
- 维度指标兼容性预检：明确说明 Data API 部分维度与指标无法同时查询，并给出
checkCompatibility()方法的实操代码，帮助避免INVALID_ARGUMENT报错——这是实际调用中最容易踩坑的细节之一。 - 与姊妹技能明确分工：SKILL.md 头部说明“不适用于 Admin API 操作（如创建属性、管理用户）”，与同仓库
google-analytics-admin-api-basics边界清晰，不重叠。 - 持续维护：本子目录最近一次实质性提交为 2026-07-24。
3. 适用场景
所属固定分类：数据分析与可视化
- 需要把 GA4 报表数据自动化取出、构建自定义仪表盘或周期性报告的开发者与数据分析师。
- 希望将网站流量、活跃用户、转化收入等指标集成进企业内部系统或 BI 流程的团队。
- 不熟悉 Data API v1beta 具体调用方式、希望借助编码助手直接生成可运行查询脚本的初中级用户。
4. 跨 Agent 兼容性
| Agent | 结论 | 判断依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 底层分发工具（npx skills，即 vercel-labs/skills）官方支持列表明确列出 claude-code，安装路径 .claude/skills/ |
| Codex | ✅ 支持 | 同一分发工具支持列表明确列出 codex，安装路径 .agents/skills/ |
| OpenClaw | ✅ 支持 | 同一分发工具支持列表明确列出 openclaw，安装路径 skills/（项目级）/ ~/.openclaw/skills/（用户级） |
| Hermes Agent | ✅ 支持 | 同一分发工具支持列表明确列出 hermes-agent，安装路径 .hermes/skills/ |
技能内容本身为纯 Markdown 文本（SKILL.md + 参考文档），不含任何平台专有代码，四个生态均可直接安装使用。
5. 推荐理由
拉取 GA4 报表数据是很多网站运营者、增长团队与独立开发者的高频需求，但 Data API v1beta 的认证配置、维度/指标兼容性规则、多语言 SDK 选型常常让人无从下手。这个技能把从启用 API、完成 ADC 认证，到构建报表查询、预检字段兼容性的完整流程整理成分语言指南与可运行示例代码，能显著降低编码助手代写 GA4 集成脚本时的出错概率，尤其适合不熟悉该 API 细节的初中级用户。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Google 团队维护，隶属仓库整体 15,235 stars 的官方技能仓库；该数字属整个合集，不代表本技能自身热度——本子目录自身讨论量有限，但曾有独立用户在仓库 issue #111 中主动提出“需要一个 Google Analytics 技能”的功能请求，随后由 PR #155 直接实现，是一条可查证的独立需求来源 |
| 可用性 | 8 | 覆盖 7 种主流语言客户端库，各配独立参考文档；含完整可运行示例与维度/指标兼容性预检方法；子目录最近一次实质提交为 2026-07-24；但需要用户自行完成 GCP 项目创建、API 启用与 ADC 认证等前置配置，非一步到位 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 无内置可执行脚本——技能全部内容为 Markdown 指导文本，正文中的 gcloud/pip 命令仅作为给用户参考的文本，用途单一（启用 API、安装客户端库），不由技能自身触发执行 |
| ② 运行时联网外发数据 | 未发现——技能不含任何网络请求逻辑；示例代码调用的是用户自己认证后的官方 GA Data API，目标透明 |
| ③ API key/凭据要求及存储方式 | 不要求硬编码任何密钥；采用 gcloud 官方 ADC（Application Default Credentials）认证机制，凭据由 gcloud 自身管理，技能本身不存储任何凭据 |
| ④ SKILL.md 与脚本中可疑指令 | 亲自抓取 SKILL.md 全文逐段核实，未发现 prompt injection 或数据外发迹象 |
| ⑤ 作者/组织信誉 | 官方 Google 团队，无造假迹象 |
| ⑥ License 是否明确 | 明确，Apache-2.0 |
| ⑦ 最近维护时间 | 本子目录最近一次实质更新为 2026-07-24 |
7. 跟同类 Skills 相比的优势
| 维度 | google-analytics-data-api-basics（本推荐） | google-analytics-admin-api-basics（同仓库姊妹技能） | google-analytics-mcp（第三方 MCP 方案，229 stars） |
|---|---|---|---|
| 定位 | 专注 GA4 报表数据查询与集成 | 专注 GA4 账户/属性配置管理（创建属性、数据流、转化事件等） | 提供 GA4 数据的 MCP 服务端点，面向支持 MCP 协议的客户端 |
| 架构方式 | 纯 Markdown 指令 + 客户端库调用，无需独立服务进程 | 同左 | 需部署并托管独立 MCP Server 进程，再由 Agent 连接 |
| 典型场景 | 拉取报表指标/维度、构建自定义报告 | 创建/管理 GA4 账户结构本身 | 让支持 MCP 的 Agent 直接对话式查询 GA 数据，内置 Schema 发现与服务端聚合 |
核心差异化：google-analytics-admin-api-basics 处理的是“配置 GA 账户”而非“读取报表数据”，与本技能场景互补而非重叠。第三方 MCP 方案（如 google-analytics-mcp）提供了更重的、需独立部署维护的服务端架构，适合已有 MCP 基础设施的团队；本技能作为轻量级 Markdown 指令，无需运行任何常驻服务，更贴合按需生成一次性查询脚本这类使用习惯。
8. 用户评价
GitHub 用户 saranshhalwai 于 2026-06-10 在 google/skills 仓库 issue #111 中反馈：此前尝试用 AI 编码助手集成 Google Analytics，效果不如预期，认为需要一个专门的 Google Analytics 技能；社区成员 dylan-k 回应指出市面已有面向 Google Analytics 的 MCP Server 方案，技能与 MCP 可以互补使用。该诉求后被仓库官方通过新增本技能与其姊妹技能予以回应。除此之外，该技能目前尚未见其他第三方平台的具名用户评价。
9. 其他补充
同一仓库的 references/ 目录为 Python、Java、PHP、Node.js、Go、.NET、Ruby 七种语言各提供一份独立安装参考，覆盖面在同类 skill 中较为完整；仓库内还收录一个专注账户/属性配置的姊妹技能 google-analytics-admin-api-basics，两者组合可覆盖 GA4 从账户搭建到报表取数的更完整链路。
10. 安装使用方式
- 通用方式（Skills CLI）：
npx skills add google/skills，从交互列表中勾选google-analytics-data-api-basics - 支持平台：分发工具官方支持列表包含 Claude Code、Codex、OpenClaw、Hermes Agent 等 70 余种编码助手
- 安装后无需重启宿主 Agent；在涉及 GA4 报表数据查询、构建自定义报告、检查维度指标兼容性等对话场景中，Agent 会依据
description字段自动匹配并加载本技能 - 前置条件：需要一个已启用 Google Analytics Data API 的 GCP 项目，以及一个拥有读取权限的 GA4 属性
11. 注意事项
- 技能本身不执行任何操作，正文给出的
gcloud/pip/Python 代码需要用户在已认证的 GCP 环境中自行运行 - 使用前需自行完成 GCP 项目创建、API 启用（
analyticsdata.googleapis.com）与 ADC 认证（需要analytics.readonly权限范围）等前置配置 - 仅覆盖 Data API（报表查询），账户/属性等管理配置需搭配姊妹技能
google-analytics-admin-api-basics或 GA 控制台完成 - 无正式 Release/Tag，采用滚动更新，如需锁定版本建议固定到具体 commit
- 部分维度与指标存在兼容性限制，无法同时查询；正文提供了
checkCompatibility()方法用于预检，但完整兼容性规则仍需查阅官方 Schema 文档交叉核实