Google Ads API 开发者助理

Google Ads API 开发者助理是 Gemini CLI 的强大扩展程序，旨在加快您的 Google Ads API 工作流程。借助该助理，您可以使用自然语言与 Google Ads API 进行交互，从而更轻松地在终端中直接提出问题、生成代码、检索数据和排查问题。

优势

  • 提高效率：减少搜索文档和编写样板代码的时间。
  • 简化复杂任务：根据简单的英语提示生成 Google Ads 查询语言 (GAQL) 和客户端库代码。
  • 了解 API：了解 API 概念，并查看自然语言请求如何转换为可执行代码。
  • 互动式调试：获取有关了解错误的帮助，以及有关问题排查的分步指南。
  • 简化的工作流程：在命令行中完成开发和测试循环。

前提条件

在开始之前，请确保满足以下条件：

  1. Google Ads API 访问权限：

  2. 软件：

    • Python 3.10 或更高版本。Python 是默认语言，因此您必须安装此语言并将其添加到路径中。
    • 已安装 Gemini CLI。
    • jq（命令行 JSON 处理程序）。如果缺少此项，设置脚本会尝试安装。

  3. 代码库：

    • GitHub 上 google-ads-api-developer-assistant 代码库的本地克隆：

开始使用

  1. 导航到项目目录：

    cd <full path>/google-ads-api-developer-assistant

  2. 运行设置脚本：此脚本会配置 Gemini CLI，以使用助理的 GEMINI.md 上下文文件和必要工具。

    ./setup.sh

    如果您使用的是 Windows，请运行 setup.ps1 PowerShell 脚本。

  3. 启动 Gemini CLI：

    gemini

  4. 与 Google 助理互动： 您现在可以使用自然语言提问或发出指令。

主要特性

  • 自然语言问答：询问有关 Google Ads API 功能、最佳实践或特定资源的问题。

    • “可供使用的广告系列类型有哪些？”
    • “如何在 GAQL 中按日期过滤？”
    • “Explain the difference between click_view and impression_view.”

  • 代码生成：生成 GAQL 查询和可执行的 Python 代码段。

    • “显示过去 30 天内转化次数最多的广告系列。”
    • “获取广告系列 ID 为 12345 的所有已启用的广告组名称。”
    • “查找所有广告系列中被拒登的广告。” 生成的代码会保存在 saved_code/ 目录中。

  • 直接执行 API：直接从 Gemini CLI 运行生成的只读 Python 脚本，并在终端中查看格式化的结果。Google 助理生成代码后，您会收到屏幕提示：

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

输入 run，脚本将在助理上下文中执行。

  • CSV 导出：将 API 调用的表格结果保存到 CSV 文件中。

    • “将结果保存到 CSV 文件中。” 文件保存在 saved_csv/ 目录中。

  • 问题排查帮助：获取有关错误消息或意外 API 行为的帮助。

    • “我收到了‘AuthenticationError.OAUTH_TOKEN_INVALID’错误，该怎么办？”
    • “为什么我的查询没有返回任何结果？”

应用场景示例

  • 报告：
    • “请按费用从高到低列出客户 12345678 上个月的前 5 个关键字。”
  • 账号结构：
    • “列出所有广告系列名称及其 ID。”
  • 问题排查：
    • “我上传了 100 次转化，但界面中只显示了 78 次。如何使用 API 调试此问题？"
  • 学习：
    • “请逐步说明如何使用 API 制作效果最大化广告系列。”

社区和支持

贡献指南

欢迎大家踊跃贡献！如需了解相关准则，请参阅 GitHub 代码库中的 CONTRIBUTING.md 文件。