Google Ads API Explorer

Google Ads API Explorer 是一种交互式执行环境，可让您直接通过浏览器构建和发送实时 API 请求。它嵌入在参考文档中，可处理 OAuth 2.0 身份验证和 JSON 载荷格式设置的复杂性，让您无需编写任何代码即可测试特定服务和方法。

福利

  • 无代码测试： 直接通过文档执行实时 API 调用（读取和写入），而无需设置本地开发环境。
  • 协议发现： 查看 HTTP 请求和响应的确切结构，了解 API 的行为方式。
  • 低摩擦原型设计： 在应用中实现逻辑之前，立即验证端点行为并检查原始 API 响应。
  • 简化的身份验证： 该工具会自动管理 OAuth 2.0 流程，让您可以专注于 API 请求，而不是凭据管理。

使用入门

  1. 前往文档： 转到参考 文档，然后选择要 测试 的服务和方法，例如 GoogleAdsService/Search。
  2. 打开 Explorer： 在页面右侧找到“试用！”面板。
  3. 配置请求：
    • 输入必需的请求参数，例如 developer-token 和 login-customer-id。
    • 如果该方法需要有效负载（例如 mutate 操作），请使用交互式 JSON 编辑器定义请求正文。
  4. 执行： 点击“执行”以发送请求。该工具将显示完整的 HTTP 请求和来自 API 的实时 JSON 响应。

主要特性

  • 实时执行： 针对您的生产账号或测试账号执行实时 search 和 mutate 操作。
  • JSON 有效负载格式设置： 以交互方式为请求构建复杂的 JSON 对象，该工具会突出显示必需的字段和有效的架构结构。
  • 字段掩码： 测试 update_mask 逻辑，了解部分资源更新在实践中的行为方式。
  • 错误检查： 在原始响应中查看详细的错误消息和代码（例如 QUERY_ERROR 或 AUTHENTICATION_ERROR），以便更快地进行调试。
  • 代码导出： 从 API Explorer 的展开视图中导出 curl 命令、原始 HTTP 请求或示例 JavaScript 代码。

应用场景示例

  • 审核账号设置： 通过执行 get 或 search 请求，快速检索账号级配置或元数据。
  • 测试突变： 在将代码部署到生产环境之前，验证广告系列创建或预算更新是否成功。
  • 调试 GAQL： 使用 Explorer 运行 Google Ads 查询语言 (GAQL) 字符串，并验证返回的 JSON 结构是否符合应用的预期。
  • 协议验证： 检查特定 API 版本所需的 HTTP 标头和 JSON 嵌套。