Google Data Manager API 受众导入助手
指导开发者将受众成员安全、可诊断地上传到 Google Ads 或 DV360。
技能要求先确认目标账户类型，说明目的地、登录账户和关联账户，并要求规范化、哈希/加密标识符、处理同意状态及支持 validate_only；但未明确最小权限、上传前用户确认、敏感数据留存/日志策略、撤销或回滚机制，也未说明依赖版本与供应链安全，因此扣分。
工作流、字段陷阱、异步状态查询、指数退避和错误诊断说明较完整，且明确 validate_only 时不要查询诊断；但依赖外部文档和样例，未提供提交的测试、版本锁定、可复现路径或针对异常输入的完整失败反馈。静态评估按上限取分。
目标受众和 Customer Match、移动设备 ID 等场景清楚，并明确不适用于事件或转化上传，也要求目的地不明时澄清；但未定义更多非适用边界、触发细则或中文使用支持，核心功能依赖 Google 海外服务，可能受中国大陆网络可达性影响，因此扣分。
技能具有元数据版本 1.1、分步结构、关键陷阱、故障排查和外部参考；仓库 README 提供 Apache-2.0、安装方式、问题反馈和活跃开发说明。但技能本身缺少安装依赖细节、FAQ、变更记录、明确维护负责人和更新流程，因此扣分。
内容覆盖目的地选择、样例获取、字段映射、构造请求、校验模式、发送及异步诊断，能够支持核心实现；但没有完整可直接运行的端到端输出，关键步骤依赖外部资料，未提供代表性结果或与手工/替代方案的比较，静态评估不超过 7 分。
提供 Google 官方开发者文档、API 参考和 Google 维护的多语言样例链接，具备一定的主材料可追溯性；但未提供提交测试套件、CI 执行证据或独立交叉验证，且本次未执行代码，因此按静态上限取 5 分。
- 上传涉及用户身份数据；必须在实际发送前确认合法授权、同意状态、最小权限和安全日志策略。
- 技能依赖外部 Google 文档、客户端库和服务；应在目标网络环境中验证可达性，并核对当前 API 版本和样例是否仍兼容。
- 异步 HTTP 200 仅表示请求接收，不代表记录成功；必须保存 request_id 并查询诊断结果。
这个 Skill 能做什么，适合哪些场景？
该技能指导开发者使用 Data Manager API 的 v1/audienceMembers/ingest 端点上传受众成员。它覆盖 Google Ads Customer Match、移动设备 ID 受众及其他受支持的受众场景。技能要求先确认目标账户类型，并参考对应的上传文档和语言代码示例。它还强调数据格式化、同意状态、验证模式、异步状态查询及错误诊断。
它要求确认数据目标产品和账户类型，读取对应的 Data Manager API 文档、代码示例和迁移字段映射指南；指导初始化 IngestionServiceClient，构造 Destination 和 IngestAudienceMembersRequest，使用工具库规范化、哈希或加密用户标识符，并设置 consent permissions 和 validate_only。发送 ingest_audience_members 请求后记录 request_id，并通过 retrieve_request_status 检查异步处理结果、记录数量、匹配率、错误和警告。
- 负责 Google Ads Customer Match 集成的开发者需要上传经过处理的电子邮件、电话号码或地址标识符。
- 负责 Display & Video 360 Customer Match 的工程师需要构造对应目标并导入受众成员。
- 从其他 Google API 迁移 Customer Match 代码的团队需要使用字段映射指南重构请求。
- 需要先验证请求模式而不实际上传数据的开发者需要使用 validate_only。
- 需要排查部分成功或失败上传的工程师需要轮询请求状态并检查诊断信息。
这个 Skill 有哪些优点和局限？
- 覆盖从目标确认、数据格式化、请求构造到异步诊断的完整流程。
- 明确列出地址字段、同意枚举、字段名称和 product_destination_id 等常见陷阱。
- 提供 Python、Java、PHP、Node 和 .NET 示例入口。
- 支持 validate_only，便于在上传前验证请求模式。
- 不会替代认证和库安装流程，需要另行参考 data-manager-api-setup 技能。
- 依赖目标产品对应的官方文档和客户端或工具库。
- 异步处理要求至少发送 30 分钟后再开始轮询状态。
- SKILL.md 未提供自动化测试套件或具体运行环境版本信息。
如何安装这个 Skill？
该技能属于 google/skills 集合。按 README 提供的命令运行：npx skills add google/skills，然后在安装选择中选择 Data Manager API Audience Ingestion。源材料未说明具体安装目录或单独安装该技能的命令。
如何使用这个 Skill？
在支持 Agent Skills 的客户端中，将技能目录中的 SKILL.md 作为技能使用，并提出类似请求：“帮我用 Data Manager API 将 Customer Match 受众成员上传到 Google Ads，使用 Python。”使用前必须明确说明目标账户类型，例如 Google Ads 或 DV360；如果目标未说明，应先澄清。若编写或更新脚本，应先获取对应语言的官方示例。
这个 Skill 与同类方案有什么区别？
与 data-manager-api-event-ingestion 技能相比，本技能处理受众成员上传，不处理事件或转化上传；与 data-manager-api-setup 技能相比，本技能聚焦受众导入实现，而非访问设置和库安装。