Google Ads API 快速入门
帮助开发者完成 Google Ads API 认证、环境配置并运行首个广告系列查询。
文档明确要求使用标准 OAuth 范围、测试账户限制，并禁止暴露密码、绕过令牌校验或使用破解包装器；但示例涉及 refresh token、client secret 和服务账户私钥，未充分说明秘密存储、日志隔离、用户确认、数据流、撤销或回滚，因此扣分。
主流程、配置搜索顺序和常见错误说明较完整，但动态版本要求与离线硬编码回退相互矛盾，Java 仍写明 JDK 1.8，多个参考文件依赖未提供的运行时版本解析，且没有提交测试套件或 CI 覆盖；静态审查限制分数不超过10。
目标用户、六种客户端语言、REST 路径及常见错误触发条件较清晰，也声明了网络依赖和 MCP 非适用场景；但非适用边界、工具可用性、中文支持及中国大陆网络可达性说明不足，核心流程依赖 Google 海外服务，故扣分。
文档分层、安装步骤、配置方式、示例和局限提示较充分，仓库提供 Apache-2.0、版本元数据和官方来源；但没有明确维护负责人、变更日志或稳定更新路径，且版本占位符、配置说明和部分语言参考存在一致性缺口，因此扣分。
技能覆盖凭据准备、环境配置、检索 campaign 和错误诊断，示例输出具有直接参考价值；但版本占位符必须先动态替换，部分实现未经执行验证，REST 服务账户路线复杂且若工具或网络不可用需人工补全，故只能给中等偏低分。
引用了官方发布说明、客户端文档、源码仓库和测试账户指南，具备一定追溯性；但提交材料未包含该技能的测试套件、CI 执行证据或第三方复现记录，示例输出也只是说明性内容，因此证据覆盖有限。
- 不要把示例凭据、refresh token 或服务账户私钥提交到仓库、日志或聊天记录；应先确认目标账户和请求范围。
- 动态版本解析、离线回退值与各语言参考文件存在冲突，生成代码前应人工核对当前 API、库和运行时兼容性。
- 核心功能依赖 Google Ads API、Google Cloud 和浏览器 OAuth；受限网络环境（包括中国大陆网络）可能无法完成流程。
- 该评估仅基于静态文件阅读，未执行安装、认证、编译、请求或测试。
这个 Skill 能做什么，适合哪些场景？
该技能面向首次使用 Google Ads API 的开发者，从零开始配置开发者令牌、OAuth 2.0 凭据、客户账号 ID 和登录客户 ID。它支持 Python、Java、.NET、PHP、Ruby、Perl 官方客户端库以及直接调用 REST。技能会引导用户运行检索广告系列的示例，并诊断 USER_PERMISSION_DENIED、DEVELOPER_TOKEN_NOT_APPROVED 和 login_customer_id 配置问题。生成代码或配置前，它要求动态解析 API、客户端库和语言运行时版本。
指导用户在 Google Ads Manager Account 中获取开发者令牌，在 Google Cloud Console 中启用 Google Ads API、配置 OAuth 同意屏幕并创建桌面应用凭据；通过 gcloud CLI 获取刷新令牌；确认客户账号 ID 和 Manager Account 的 login_customer_id；根据所选语言或 REST 路径加载对应参考文件；生成用于检索广告系列的示例配置或请求；根据账号层级和令牌状态分析常见错误。
- 刚开始使用 Google Ads API 的开发者需要完成首次认证和环境配置。
- 使用 Manager Account 访问子客户账号并遇到 USER_PERMISSION_DENIED 的开发者。
- 开发者令牌仍处于 Pending 状态、需要连接测试账号的开发者。
- 希望用官方客户端库或原始 HTTP REST 请求检索广告系列的开发者。
- 需要为受限运行时或无合适客户端库的环境选择 REST 集成方式的开发者。
这个 Skill 有哪些优点和局限？
- 覆盖从凭据获取到首次广告系列查询的完整入门流程。
- 同时支持六种官方客户端库和直接 REST 调用。
- 明确处理 Manager Account 层级、测试账号和待审批开发者令牌限制。
- 包含动态版本解析要求和常见认证错误诊断。
- 该技能依赖出站 HTTPS 访问 Google Ads API 和文档，网络受限时只能使用缓存版本。
- 源材料没有提供各语言参考文件的具体内容，因此无法判断每种语言示例的完整程度。
- 源材料未显示测试套件、执行验证结果或对其他运行时的支持。
- 技能本身不负责为 AI 助手配置 Google Ads MCP Server，而是要求转交另一个技能。
如何安装这个 Skill？
在支持 Agent Skills 的环境中运行 npx skills add google/skills，然后从仓库中选择 skills/ads/google-ads-api-quickstart。仓库 README 未说明更细的客户端安装或平台专属安装步骤。
如何使用这个 Skill？
可使用类似“请带我完成 Google Ads API 的首次配置，并用 Python 检索广告系列”的请求触发。先准备开发者令牌、OAuth 客户端凭据、刷新令牌、客户 Customer ID，以及在 Manager Account 层级中需要的 login_customer_id；然后选择六种官方客户端库之一或 REST。网络受限时，技能说明会使用资源中缓存的最近稳定版本。
这个 Skill 与同类方案有什么区别？
技能将官方客户端库与直接 HTTP REST 作为两种集成路径进行比较：客户端库是推荐路径，REST 适合不支持客户端库的轻量或受限运行时。