Google Ads API Explorer

Google Ads API 浏览器是一个交互式执行环境，可让您直接通过浏览器构建和发送实时 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 探索器的展开视图中导出 curl 命令、原始 HTTP 请求或 JavaScript 示例代码。

应用场景示例

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