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 嵌套。