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. 配置请求：
    • 输入必需的请求参数（例如customerId），然后 展开标头以提供可选的 HTTP 标头，例如 login-customer-id（仅在通过 管理账号访问账号时需要）。请注意，开发者令牌 (developer-token) 已于 2026 年 9 月 9 日停用，API 服务器会忽略这些令牌，但如果表单提示您输入值，您仍然可以输入。
    • 如果该方法需要有效负载（例如用于 search 或 mutate 操作），请使用交互式 JSON 编辑器定义请求正文 。
  4. 执行： 点击执行 以发送请求。该工具会显示完整的 HTTP 请求和来自 API 的实时 JSON 响应。

主要特性

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

应用场景示例

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