2026 年 8 月 25 日，星期二
Google Ads API 开发者助理的主要版本现已推出。此版本将该助理从独立项目设置转变为统一的插件架构，旨在将专门的 Google Ads API 功能直接引入 AI 智能体工作流。
这是什么？
Google Ads API 开发者助理将深厚的 Google Ads 领域专业知识融入 Antigravity 和 Claude Code 等 AI 编码环境。它为 AI 助理配备了专用工具和安全防护机制。功能包括：
- 生成惯用代码：创建经过测试、符合最佳实践的集成代码，支持 Python、Java、PHP、.NET 和 Ruby。
- 验证 GAQL 查询：在运行查询之前，自动验证语法、字段兼容性、日期细分和零展示规则。
- 检查 Protobuf 架构：按需发现任何有效 Google Ads API 版本的资源字段、数据类型和枚举定义，以确保 GAQL 查询字段有效。
- 排查 API 问题：诊断线下转化数据上传失败问题、浏览经理账号层次结构，以及构建效果最大化广告系列商品信息过滤条件。您可以使用自然语言提出问题，例如“显示我账号中存在问题的所有广告，并推荐解决方法”。
- 回答 API 问题：该助理通过将嵌入式 Google Ads API 架构规则与动态本地 Protobuf 架构检查相结合来回答问题，从而提供版本准确的指导和经过验证的代码段。它直接根据官方 API 定义和客户端库源代码生成回答，而不是仅仅依赖于通用模型训练。例如，您可以提出这样的问题：“什么是共享集？如何使用共享集？”
- 即席报告：您可以使用简单的英语询问效果数据，助理会立即直接针对您的 Google Ads 账号构建、验证和运行所需的 GAQL 查询。它会将实时结果以简洁、格式化的表格形式流式传输回对话中，让临时报告和指标调查变得轻松自如。如果您想保存结果，请让它“将结果保存为 <您的目录> 中的 CSV 文件”，然后您就可以将其加载到电子表格中进行分析。
支持 Antigravity 和 Claude Code
此版本引入了双平台支持：
- Antigravity：原生支持 Antigravity 开发环境，并提供全局和工作区插件注册。
- Claude Code：与 Claude Code CLI 插件系统完全集成，包括自定义斜杠命令（例如
/validate-gaql、/inspect-object、/troubleshoot-conversions和/get-cids）。
统一安装脚本适用于 Linux、macOS (bash) 和 Windows (PowerShell)，可在所有三个平台上提供一致的生命周期管理。
性能改进
- 减少 token 消耗：渐进式披露规则和架构仅加载给定任务所需的上下文，从而减少提示 token 开销。
- 响应速度更快：按需执行技能和有针对性的命令路由，可更快地完成端到端任务。
- 降低 CPU 利用率：简化的执行流水线可消除开发会话期间的后台进程开销。
- 减少磁盘 I/O：减少插件树中不必要的文件数量，可防止文件监视器、linter 和 IDE 索引器扫描数万个未使用的 protobuf/SDK 文件。
- 更低的内存 (RAM) 占用和零守护进程开销：技能和命令现在仅在调用时作为快速子进程临时运行，在空闲时系统资源用量会降至零。
- 缓存的 API 版本和 Protobuf 架构解析：在检查标准字段、资源和枚举时，助理会避免进行重复的远程元数据或反射 API 调用。
- 确定性命令执行与多轮 LLM 推理：本地验证器只需一步即可检查字段、资源、零展示指标和日期子句，而无需 LLM 在 3-4 轮往返中猜测或迭代调试 GAQL 语法。
基于现代插件架构构建的主要版本
这是一个主要版本，与之前的版本不兼容。早期版本依赖于本地工作区项目结构。此版本基于标准化的插件架构构建，安装后可在全球范围内使用。
将规则、技能和诊断命令模块化为独立的插件包，使开发者能够在多个环境和项目中安装、更新和管理助理。
如需了解插件架构的技术详情，请参阅 README.md。
使用入门
由于此版本中的架构发生了变化，请在安装前查看相关文档：
- 请阅读 README_BEFORE_INSTALLATION.md，了解前提条件和环境准备工作。
- 按照 README.md 中的安装说明进行操作。
我们期待您的反馈
您可以使用调查问卷表单分享反馈、报告问题和建议功能：
👉 提交反馈
标签： google-ads-api、 release