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 视频指南。