1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | data-manager-api-setup-google-skills |
| 作者/维护者 | Google（google/skills 官方仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/ads/data-manager-api-setup |
| 许可证 | Apache License 2.0（数据来自 GitHub API，仓库级） |
| GitHub Stars | 19,779（合集仓库整体，非本技能独立热度，数据来自 GitHub API） |
| Forks | 1,592（合集仓库整体，数据来自 GitHub API） |
| 最新版本 | 无独立版本号（SKILL.md 内部标注 metadata.version 1.0）；该子目录最近一次实质提交为 2026-07-09（目录整理） |
| 安装方式 | npx skills add google/skills/skills/ads --agent=claude-code，或手动复制该子目录到 agent 的 skills 目录 |
2. 功能介绍与亮点
本技能指导开发者完成接入 Google Data Manager API 前的全部准备工作：启用 API、用 Application Default Credentials（ADC）完成本地认证（含所需 OAuth scope 与服务账号模拟角色说明），再按目标语言安装官方客户端库与配套工具库。
亮点：
- 覆盖 Python、Java、Node、PHP、.NET 五种语言，每种都配一份独立的参考文档，且全部以本地文件形式随技能打包，不依赖外部网页才能读到关键步骤。
- 明确区分“客户端库”（可从 PyPI/Maven/npm 等公共包管理器直接安装）与“配套工具库”（官方尚未上架公共包管理器，需要克隆仓库本地构建）两条路径，避免开发者误以为一条
pip install就能装全。 - SKILL.md 头部明确写出“不要用它做什么”——受众数据/事件的实际写入逻辑分别属于同仓库另外两个技能（audience-ingestion、event-ingestion），本技能只管“能不能连上”，边界清晰不越权。
3. 适用场景
所属分类：集成与工作流自动化
适用于首次接入 Google Data Manager API 的开发者：已获得 Google Ads 或 Google Analytics 账号访问权限、需要为线下转化/受众数据回传搭建认证与客户端环境的营销技术（MarTech）工程师，以及需要在多语言技术栈中快速核对官方安装步骤的团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持——标准 SKILL.md 格式，Google 官方文档明确列出 Claude Code 为受支持的 Agent Skills 标准客户端之一，可经
npx skills add安装或手动放入.claude/skills/。 - Codex：需适配——技能本身只是纯文本指导（无自带脚本），但引导用户执行的
gcloud auth、pip/git clone等命令需要网络与本地 Shell 权限，Codex 默认沙箱无网络访问，需先放开网络与云凭据配置才能走完整流程。 - OpenClaw：未验证——采用同一开放 SKILL.md 规范，理论上可直接安装，但未找到官方或第三方的明确验证说明。
- Hermes Agent：未验证——同上，规范兼容但未查到明确验证来源。
（核验依据：Google Data Manager API 官方文档“Agent Skills”章节列出的受支持客户端说明，以及 npx skills 安装器的 --agent 参数选项。）
5. 推荐理由
Google Data Manager API 的账号接入本身涉及启用 API、配置 ADC 认证 scope、区分公共包与需本地构建的工具库等多个容易踩坑的细节，官方把这些步骤连同五种语言的差异一次性写清楚并随技能打包，能省去开发者反复查阅多份分散文档、自行摸索“这条 pip install 装的是不是全部”的过程，是后续两个数据写入技能能真正跑起来的前置基础。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 Google 官方发布，Google 正是 Data Manager API 的实际提供方；所属仓库为多技能合集，19,779 星是仓库整体数字不代表本技能自身热度；未查到该子技能自身的独立第三方讨论 |
| 可用性 | 7 | 步骤清晰、五种语言参考文档完整且随技能打包；但“配套工具库”在全部五种语言下均需额外 git clone 到本地构建、无法直接从公共包管理器安装，且需要提前具备已启用 API 的 Google Cloud 项目与相应账号权限，比纯一条命令复制即用多几步；该子目录最近一次实质提交为 2026-07-09（约两个月前），仓库整体持续活跃（最近一次提交为 2026-09-11） |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：① 引导执行的 Shell 命令仅为标准 gcloud auth application-default login（官方 CLI，作用域已在文档写明）与各语言标准包管理器安装命令，范围明确 ② 无隐蔽网络外发，客户端库安装源均为官方公共仓库（PyPI/Maven Central/npm/Packagist/NuGet）与 Google 官方 GitHub 仓库 ③ 使用标准 ADC 机制认证，不涉及在本地明文存储密钥 ④ 逐份核对 SKILL.md 与五份参考文档，未发现可疑指令或与任务无关的夹带内容 ⑤ 作者为 Google 官方仓库，信誉最高档 ⑥ 许可证明确（Apache-2.0） ⑦ 所属仓库持续活跃维护
7. 跟同类 Skills 相比的优势
| 技能 | 平台/范围 | 与本技能的差异 |
|---|---|---|
| google-ads-api-quickstart-google-skills | Google Ads API（非 Data Manager API）的凭据配置与“检索广告系列”示例脚本 | 服务的是另一个 API 产品线（开发者令牌审批、login-customer-id 等 Google Ads API 专属概念），与 Data Manager API 的 ADC 认证体系不通用 |
| data-manager-api-audience-ingestion-google-skills | Data Manager API 的受众数据增删逻辑 | 本技能是它的前置依赖——负责“环境能不能连上”，不涉及受众数据的具体读写操作 |
| data-manager-api-event-ingestion-google-skills | Data Manager API 的转化/事件数据回传逻辑 | 同上，与本技能互补而非重叠，二者的 SKILL.md 均明确注明具体数据写入请改用各自技能 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 安装使用方式
- 命令行安装：
npx skills add google/skills/skills/ads --agent=claude-code（可按提示只勾选data-manager-api-setup） - 手动安装：将
skills/ads/data-manager-api-setup整个目录（含references/子目录）复制进所用 agent 的 skills 目录 - 使用前提：已在 Google Cloud 项目中启用 Data Manager API，并准备好可用于该项目的账号或服务账号
- 安装后无需重启，在对话中提出“如何接入 Data Manager API”或类似认证配置需求即会触发对应指导流程
10. 注意事项
- 只覆盖认证与客户端库安装，不包含受众/事件数据的实际写入逻辑，需配合同仓库另外两个技能使用
- 五种语言中的“配套工具库”均未上架公共包管理器，必须走
git clone+ 本地构建路径，纯pip install/npm install不能获得完整功能 - 服务账号模拟（impersonation）等高级认证配置需要额外的 IAM 角色授权，超出个人开发者账号的默认权限范围