Google Ads API 开发者助理 v1.0 隆重推出：使用自然语言与 API 互动

2025 年 12 月 10 日，星期三

Google Ads API Developer Assistant 现已发布，这是一款功能强大的 Gemini CLI 扩展程序，旨在简化 Google Ads API 工作流。借助此工具，您可以使用日常语言与 Google Ads API 进行交互，从而比以往更轻松地获取信息、生成代码，甚至直接在终端中检索数据。
无论您是 Google Ads API 的新手还是经验丰富的开发者，此助理都能帮助您提高工作效率。

用途

Google Ads API Developer Assistant (v1.0) 通过以下几项关键功能增强了 Gemini CLI：

  1. 自然语言问答：对 Google Ads API 有疑问？只需开口提问！
    • “有哪些广告系列类型？”
    • “请介绍一下效果最大化广告系列的报告。”
    • “如何在 GAQL 中按日期过滤？”
  2. 自然语言到代码生成：描述您需要的数据，助理将生成 Google Ads 查询语言 (GAQL) 和可执行的 Python 代码，并使用 google-ads-python 客户端库作为上下文，确保代码符合最佳实践。
    • “显示过去 30 天内转化次数最多的广告系列。”
    • “获取客户‘123-456-7890’的所有广告组。”
    • “查找所有广告系列中被拒登的广告。”
    • 生成的代码会自动保存到 saved_code/ 目录。
  3. 直接执行 API：直接从命令行运行生成的 Python 脚本。助理将执行只读 API 调用并显示结果，这些结果通常会在终端中以表格形式整齐地呈现。
  4. CSV 导出：需要保存数据？您可以轻松地将 API 调用的表格结果导出为 CSV 文件。只需说：
    • “将结果保存到 CSV 文件”
    • 文件会保存在 saved_csv/ 目录中。

该乐器的工作原理是怎样的？

此扩展程序利用了 Gemini CLI 的功能，可使用 GEMINI.md 文件中的上下文和 .gemini/settings.json 中的设置。通过为助理配置本地 google-ads-python 库克隆和示例目录的路径，它可以提供相关且准确的代码生成。

使用入门

以下是您需要满足的条件：
前提条件：

  • 熟悉 Google Ads API 概念和身份验证。
  • Google Ads API 开发者令牌。
  • 主目录中已配置的 google-ads.yaml 凭证文件。
  • Python >= 3.10。
  • 已安装 Gemini CLI。
  • google-ads-python 客户端库的本地副本。（设置脚本可以为您克隆此代码库。）

如需查看详细的设置说明和示例，请参阅 GitHub 代码库中的 README 文件。

在哪里可以找到

Google Ads API 开发者助理可在 GitHub 上获取。

社区和支持

我们建议您试用一下！您的反馈非常宝贵，请在此调查问卷中提供。欢迎在 Discord 的 #ads-api-ai-tools 频道中加入讨论。

请使用代码库中的 GitHub“Issues”（问题）标签页报告 bug、提出功能建议或寻求支持。如需了解贡献指南，请参阅 CONTRIBUTING.md。

祝您编码愉快！
Bob Hancock，Google Ads API 团队

标签： google-ads-api、 release