Google Ads API 开发者助理 (v4.0.0) 并非通用聊天机器人。它是一个专门用于 AI 赋能的广告工程的任务控制系统，基于 Google Antigravity 和 Claude Code 代理框架构建。
自然语言问答和特定于业务的上下文
您可以使用简单自然的语言向 Google 助理提问和提出要求。助理会分析您的意图，参考官方 API 架构，并提供清晰的说明、可用于生产用途的代码或实时数据：
- 自然语言说明：您可以就 Google Ads API 概念、资源层次结构、报告指标或细分规则提出问题，以获得清晰的概念性概览和架构说明。
- 有针对性的代码生成：当您的任务需要实现时，助理会提供符合语言习惯且可用于生产用途的客户端库代码段、变更脚本或 GAQL 查询，这些代码段、脚本或查询会根据您的编程语言和使用情形量身定制。
- 问题排查和错误诊断：粘贴 API 错误消息、gRPC 状态代码或意外的集成行为。助理会诊断根本原因，说明问题发生的原因，并提供必要的代码更正或配置修复。
- 临时报告：以简单明了的语言请求账号效果数据和广告系列指标。助理可直接针对您的账号构建、验证和运行 GAQL 查询，并在终端中显示格式化结果或将其导出为 CSV 文件。
- 代码库中的特定于业务的上下文：使用
--context_dir设置参数注册您自己的项目代码库。通过分析您现有的数据流水线、辅助实用程序和业务逻辑，助理可以量身定制其说明、问题排查和生成的代码，以便与您的内部系统无缝集成。
概览：解决高合规性摩擦
此助理解决的根本问题是认知超负荷和技术难题。
Google Ads API 是功能最强大但也是最复杂的 API 之一。它具有严格的版本控制、独特的查询语言 (GAQL)、深度嵌套的 Protocol Buffer 结构和严格的安全要求。开发者通常会花费大量时间来调试 gRPC 错误、查找字段兼容性并修复 lint 问题，而不是构建实际的业务逻辑。
在 4.0.0 版中，Google 助理通过引入模块化插件架构来解决此问题，该架构由经过测试的专业技能和内置的斜杠命令提供支持。它充当自动化专家中间件，可处理版本验证、架构发现和代码检查等繁琐任务，让开发者能够从意图层面（而非语法层面）进行操作。
基于官方架构，而非猜测
标准大语言模型通常难以处理特定领域的 API，因为它们依赖于通用训练数据，而随着新 API 版本的发布，这些数据很快就会过时。
Google Ads API 开发者助理通过将嵌入式 Google Ads API 架构规则与动态本地 Protobuf 架构检查相结合来解决此问题：
- 确定性验证：助理不再依赖于多次往返的迭代 LLM 猜测，而是运行本地 4 步验证流水线，以在单个步骤中验证字段兼容性、资源关系、零展示规则和日期细分。
- 版本精确的架构查找：直接从有效 API 版本的官方 API 架构检查 Protobuf 资源定义、数据类型和枚举值，避免重复的远程元数据查询。
- 官方客户端库基础：代码生成直接基于 Python、Java、PHP、.NET 和 Ruby 中的官方 Google Ads 客户端库。
类比：专业研究和诊断实验室
您可以将该助理视为外科医生的一个高科技研究实验室。
- 外科医生（开发者）：您知道需要执行什么手术（例如，“我需要分析效果最大化广告系列的效果”）。
- 实验室设备 (API)：这些是执行手术所需的功能强大的工具，但它们非常精密，需要精确校准。
- 实验助理（此工具）：在您触碰患者之前，实验助理会使用专门的技能和内置命令来：
- 检查手册：自动验证最新的 API 协议，并实时检查资源结构 (
inspect_object//inspect-object)。 - 预先测试工具：使用实时 API 验证 (
validate_gaql//validate-gaql) 对查询执行确定性试运行，以便在发生错误之前发现错误。 - 对环境进行消毒：使用严格的 lint 流水线（
rufflinting）对代码进行格式化和清理，以免导致系统错误。 - 监控生命体征：监控 API 异常，并针对线下转化 (
troubleshoot_conversions//troubleshoot-conversions) 等复杂操作运行高级诊断工作流。 - 解释概念：用日常语言和现实世界的类比（
/explain、/step-by-step、/assistant-tutorial）解释复杂的概念。
- 检查手册：自动验证最新的 API 协议，并实时检查资源结构 (
互联性：安全第一的桥梁
助理充当桥梁，连接项目中的四个不同“世界”，并受控制合约 (AGENTS.md / CLAUDE.md) 的约束：
- 用户背景信息：它会听取您的高级目标，并将其转化为技术策略。
- 本地工作区：它在项目目录中拥有“眼睛和双手”。 它可以读取现有代码并编写新代码以供日后使用，同时保持严格的隔离。
- Google Ads API：它会连接到实时 API，以针对您的账号运行只读报告和测试查询。为了快速验证字段，它会直接检查本地 Protobuf 架构。
- 安全门卫：它被硬编码为遵循严格的协议。如果脚本未经过 Lint 检查，它不会允许您运行该脚本；如果查询未通过程序化验证检查，它不会允许您发送该查询。
Google 助理能做些什么
简单来说，助理是您的安全保障和加速器。
- 可防止出错：在执行代码和查询之前，它会根据有效的 API 架构对其进行验证，从而在语法和兼容性错误到达实时 API 之前将其停止。
- 了解地图：它了解 Google Ads API 的地理位置，知道数据位于何处以及如何高效查询数据。
- 它可以自动执行一些繁琐的任务：编写样板客户端库代码、将报告格式化为简洁的终端表格，以及处理客户端库管道。
- 它可以排查复杂的工作流程：它会对线下转化上传运行深度诊断，解决 MCC 账号层次结构问题，并配置复杂的广告系列结构，例如效果最大化广告系列的商品详情过滤条件和网址排除对象。
- 它会实时流式传输临时报告：以纯英语询问效果数据，助理会直接针对您的账号构建、验证和运行 GAQL 查询，并将格式化的结果流式传输到您的终端或将其导出为 CSV。
- 保持最新状态：通过检查本地 Protobuf 架构和有效 API 版本的文档，帮助您避免使用已废弃的字段和过时的规则。
Google Ads API 开发者助理将“开发者与 API”之间的斗争转变为“开发者 + AI”的协作，从而生成安全、地道且架构合理的代码。
架构和性能 (v4.0.0)
版本 4.0.0 将助理从独立项目设置过渡到现代化的全局插件架构：
- 零守护程序开销：技能和诊断命令仅在被调用时以轻量级子进程的形式临时运行，在空闲时将系统资源用量降至零。
- 渐进式上下文披露：仅在与当前任务相关时按需加载规则和架构，从而显著减少令牌消耗和提示延迟。
- 减少磁盘 I/O：从插件树中移除不必要的 SDK 文件可防止 IDE 索引器、lint 工具和文件监视器扫描数万个未使用的文件。
- 支持多平台主机：可在 Google Antigravity 和 Claude Code 环境中顺畅运行，并在 Linux、macOS 和 Windows 上使用统一的安装脚本。