Google Ads 查询验证器

Google Ads 查询验证工具是一款互动式工具，旨在帮助开发者在将 Google Ads 查询语言 (GAQL) 查询集成到应用之前构建和验证这些查询。借助该工具，您可以输入 GAQL 查询字符串并立即收到有关其有效性的反馈，从而在开发过程的早期发现语法错误、字段不兼容问题和其他问题。

福利

  • 防止错误： 在无效查询集成到应用之前尽早发现这些查询，从而减少运行时错误和 API 调用失败。
  • 加快开发速度： 无需完整的 API 请求和响应周期开销，即可快速测试和调试 GAQL 语句。
  • 了解 GAQL 限制： 帮助开发者了解有关哪些字段兼容以及资源之间如何关联的复杂规则。
  • 调试查询： 在查询无效时提供具体错误消息，这些消息通常比通用 API 错误更详细，有时还会提供有效的替代方案。
  • 提高资源效率： 避免使用注定会失败的查询进行不必要的 API 调用。

运作方式

查询验证工具会根据 Google Ads API 的架构和 Google Ads 查询语言中定义的规则解析您的 GAQL 查询。它使用元数据（其中大部分可从 GoogleAdsFieldService 访问）执行检查，包括：

  1. 语法和结构： 确保查询遵循正确的 GAQL 语法，包括正确使用和排序子句（如 SELECT、FROM、WHERE、ORDER BY 和 LIMIT）。
  2. 字段有效性： 检查所有指定的字段（资源、细分、指标）是否存在且拼写正确。
  3. 资源兼容性： 验证在 SELECT 子句中选择的字段是否与 FROM 子句中指定的主要资源兼容。
  4. 细分和指标兼容性： 确保在同一查询中一起使用的细分和指标彼此兼容，并且与 FROM 子句中的资源兼容。
  5. 子句要求： 验证规则，例如要求 WHERE 或 ORDER BY 子句中使用的某些字段也必须出现在 SELECT 子句中。
  6. 运算符使用情况： 检查 WHERE 子句条件中运算符的使用是否正确。

如果查询有效，该工具会确认这一点。如果发现问题，该工具会提供旨在帮助您找出问题的错误消息，有时还会提供修复建议，例如针对给定指标的兼容资源。

开始使用

如需使用 Google Ads 查询验证工具，请执行以下操作：

  1. 前往 查询验证工具。
  2. 输入您的 GAQL 查询。
  3. 点击验证查询 按钮。
  4. 查看查询验证器微件下方显示的验证消息。成功消息表示查询有效。否则，系统会显示描述问题的错误消息。错误消息会引导您更正查询。例如，字段不兼容错误可能会列出 与您尝试查询的指标或细分 兼容的替代资源。

如需详细了解 GAQL 概念和验证，您还可以 参阅GAQL 视频指南。