Google Ads API Developer Assistant 2.0 版隆重推出

2026 年 2 月 26 日，星期四

此次重大更新将助理从强大的代码生成工具转变为 Google Ads 开发者主动排查问题和实现自动化的合作伙伴。自 v1.6.0 版本发布以来，我们一直在倾听您的反馈，并专注于 API 开发中最具挑战性的部分：诊断、一致性和设置。

v2.0 有哪些新变化？

1. 安装和维护更简单

设置多语言开发环境不应该是一件苦差事。

  • 一键设置：使用新的 --install-deps 标志搭配 install.sh 或 install.ps1，即可一次性处理 pip、composer 和 bundler 依赖项。
  • 统一的目录结构：现在，所有生成的代码、CSV 导出文件和诊断报告都整理在单个 saved/ 目录下，并为每种类型的输出设置了子目录。
  • 一键更新：当 API 和客户端库的新版本发布时，您需要执行 update.sh 才能使用最新版本。您还可以使用 update.sh 向上下文添加其他客户端库。

2. 智能体转化问题排查

线下转化跟踪是 Google Ads API 中最强大但也最复杂的功能之一。调试转化未归因的原因可能是一个耗时的手动过程。

在 v2.0 中，我们引入了专用的转化问题排查和诊断套件。

  • 新脚本：api_examples/collect_conversions_troubleshooting_data.py
  • 新命令：/conversions_support_data

该脚本会执行标准报告以排查转化问题，并为助理提供背景信息，以便其排查您的问题。

在助理分析并尝试解决转化问题后，此命令最有用。如果无法解决，并且您需要联系支持团队，此命令将分析您的客户设置、转化操作和上传摘要，并根据已执行的分析生成结构化诊断报告。它甚至可以自动识别“不健康”状态和高故障率，为您节省数小时的日志分析时间。它会将结果保存到文本文件中，如果您需要提交支持请求，可以将该文件包含在请求中。

3. 专为最新 API (v23) 打造

2.0 版完全支持 Google Ads API v23。我们已更新所有互动式示例，并针对最新资源和字段优化了助理的内部上下文，确保生成的代码可用于生产用途。

4. 通过会话钩子实现无缝自动化

我们添加了 SessionStart 和 SessionEnd 钩子，让您的工作流程真正顺畅无阻。

  • 自动配置：现在，在会话开始时，助理可以自动在 $HOME 目录中找到您的配置文件。它会将该文件复制到项目目录中的子目录 config。Python 是 Gemini 首选的 API 查询语言。因此，如果您使用的是其他语言，它会读取您的配置文件，并在 config 中创建一个临时的 google-ads.yaml 用于查询，但仍会以您首选语言的代码进行响应。
  • 自动清理：退出时，系统会安全地擦除临时配置，从而保持工作区整洁并确保凭据安全。

5. 更智能的 GAQL 验证

构建复杂的 GAQL 查询变得前所未有的简单。我们更新了 GEMINI.md 和 conversions/GEMINI.md，针对最新的 API 极端情况制定了严格的验证规则，包括改进了对日期细分和有限范围要求的处理。现在，助理会在您执行查询之前捕获逻辑错误。

6. 技能

您可以将技能视为一个迷你插件或“行为蓝图”。虽然一般上下文（例如您的 GEMINI.md 文件）提供了背景信息，但只有在 AI 需要执行复杂的程序化任务（例如获取此扩展程序的当前版本）时，技能才会被“加载”到 AI 的大脑中。您无需直接执行技能。Gemini 会自行决定何时需要使用该信息。

虽然这仍是一项实验性功能，但我们在此版本中添加了一项功能，以补充我们对钩子的使用，从而实现会话初始化和清理。

为什么要升级？

从 v1.6.0 到 v2.0.0 的飞跃不仅仅是新功能，更是可靠性的提升。通过将深厚的 API 知识与自动化诊断工具相结合，v2.0 减少了通常会减慢 API 集成速度的“试错”循环。

无论是调试转化数据上传，还是构建复杂的报告流水线，v2.0 都能为您提供工具，让您更快速、更自信地开展工作。

开始

首次安装

从之前的版本升级

  • 将 saved_code/ 和 saved_csv/ 中的所有自定义代码复制到安全位置。
  • 删除项目目录以及所有子目录和文件，即可删除 Google Ads API 开发者助理的本地克隆。
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • 在项目目录中，运行 install.sh 或 install.ps1 以安装扩展程序和客户端库。

Bob Hancock，Google Ads API 团队

标签： google-ads-api、 release