1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | data-manager-api-audience-ingestion-google-skills |
| 作者/维护者 | Google（google/skills 官方合集仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/ads/data-manager-api-audience-ingestion |
| 许可证 | Apache-2.0（GitHub API 实测，仓库层级） |
| GitHub Stars | 19,181（合集仓库整体，GitHub API；不代表本技能自身热度，见第 7 章说明） |
| Forks | 1,548（合集仓库整体，GitHub API） |
| 最新版本 | metadata.version 1.1，最近一次针对本技能目录的提交为 2026-08-04（GitHub API commits） |
| 安装方式 | npx skills add google/skills/skills/ads --agent=<平台> |
2. 功能介绍与亮点
该技能指导开发者通过 Data Manager API 管理广告受众成员——上传、移除单个用户，或整体清空/替换一个受众列表，覆盖 Customer Match、移动设备 ID 受众等场景，目标账号可以是 Google Ads 或 Display & Video 360（DV360）。
正文按四步组织：先明确数据要发往哪个目的地（Google Ads 还是 DV360，两者字段结构不同）；再给出 Python/Java/PHP/Node/.NET 五种语言的官方代码样例链接；随附字段迁移映射表（供从旧版 Google Ads API 升级过来的用户对照）；最后是逐项实现清单——初始化客户端、构造 Destination 对象、用配套工具库格式化并哈希用户标识符、发送请求并记录 request_id、轮询请求状态。技能额外收录一份「常见坑」清单（如编码字段必须显式设为 HEX/BASE64、terms_of_service 字段在上传时必填、ConsentStatus 枚举值容易写错）和错误排查小节，均来自实际踩坑经验而非泛泛的 API 文档转述。
3. 适用场景
所属分类：集成与工作流自动化
面向需要把自有客户名单、设备 ID 等第一方数据对接进 Google Ads / DV360 广告系统的开发者与营销技术团队——典型场景包括为 Customer Match 广告定向上传/更新客户名单、批量移除或整体清空一个受众列表、或是把旧版 Google Ads API 的受众上传代码迁移到新版 Data Manager API。
4. 跨 Agent 兼容性
- Claude Code：原生支持——Google 官方文档给出专用安装命令
npx skills add google/skills/skills/ads --agent=claude-code - Codex：需适配——官方同样给出
--agent=codex专用安装命令，但 Codex 默认沙箱不带网络访问，实际执行数据上传请求前需手动开启网络权限 - OpenClaw：未验证——官方文档仅笼统声明兼容“支持开放 Agent Skills 标准的助手”，未见专门验证
- Hermes Agent：未验证——同上，未见专门验证
5. 推荐理由
把一份容易踩坑的广告数据上传流程，浓缩成一份自带常见错误清单与状态轮询步骤的可执行操作指南，覆盖五种主流语言的官方样例，对接入 Google 广告生态第一方数据的团队直接可用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方出品——Google 是 Data Manager API 的所有者；WebSearch 与 GitHub issue/PR 检索均未找到独立第三方对本技能的讨论或引用 |
| 可用性 | 9 | 正文含完整四步工作流、五语言官方样例、字段迁移表、常见坑清单与错误排查指南，另附 references/ 子目录两份专项参考文档；最近一次维护 2026-08-04，无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① 无 shell 命令执行，技能只指导生成调用官方客户端库的代码
② 会将用户提供的受众数据（经哈希/格式化处理）发送至 Google 广告服务器，属该 API 设计初衷（第一方数据激活），流程强制要求 terms_of_service 同意字段
③ 凭据通过标准 OAuth/ADC 流程管理（由配套的 data-manager-api-setup 技能负责），未见硬编码或不当存储
④ 正文与代码样例链接中未发现可疑指令或隐藏提示注入
⑤ 作者为 Google 官方团队，信誉无造假迹象
⑥ License 为 Apache-2.0，明确开源可审计
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 与本技能的差异 |
|---|---|---|
| google-ads-api-quickstart（同为 google/skills 合集） | 生成 Google Ads API 访问所需的开发者令牌、OAuth 凭据等五项基础参数 | 只负责“拿到访问权限”这一前置步骤，不涉及具体的受众数据上传逻辑 |
| google-analytics-data-api-basics（同为 google/skills 合集） | 查询 Google Analytics 报表数据（读取方向） | 数据流向相反：本技能是把数据“写入”广告系统，该技能是从分析平台“读出”数据 |
| data-manager-api-event-ingestion（同为 google/skills 合集） | 上传转化事件/离线转化数据 | 与本技能同属 Data Manager API 家族但处理对象不同：一个管理“受众名单”，一个管理“转化事件”，两者互补覆盖该 API 的两大用途 |
8. 用户评价
该技能目前在第三方平台（Reddit、Hacker News、GitHub Issues）尚无独立于官方发布公告之外的具名用户评价；GitHub 上唯一相关记录是该技能所在合集仓库的引入 PR 本身。
9. 其他补充
Data Manager API 于 2025 年 12 月正式 GA，统一了此前分散的 Customer Match、离线转化、GA4 事件三条上传管线；本技能随 API 能力迭代持续更新（如 2026-08-04 补充了移除/整体清空受众的工作流）。
10. 安装使用方式
- Claude Code / Antigravity / Cursor：
npx skills add google/skills/skills/ads --agent=<对应平台名> - 其他支持开放 Agent Skills 标准的助手：
npx skills add google/skills/skills/ads - 安装后代理会在检测到相关请求（如“上传客户名单到 Google Ads”）时自动加载该技能；也可在对话中手动通过
/唤起 - 使用前需先完成
data-manager-api-setup技能中的身份认证与客户端库安装步骤
11. 注意事项
- 首次调用前必须与用户确认数据目的地（Google Ads 还是 DV360），两者字段结构不同，技能明确要求不得默认假设
- 请求处理为异步，成功返回
request_id仅代表数据已被接收，需按技能指引轮询retrieve_request_status才能确认实际处理结果（成功/部分成功/失败） - 涉及上传经哈希处理的用户标识符（邮箱、电话、地址），使用前应确认所在组织已具备合规的用户同意与数据处理依据