Google Ads 查询验证器是一款交互式工具，旨在帮助开发者在将 Google Ads 查询语言 (GAQL) 查询集成到应用之前，先构建和验证这些查询。您可以输入 GAQL 查询字符串，并立即收到有关其有效性的反馈，从而在开发过程的早期发现语法错误、字段不兼容和其他问题。
优势
- 错误预防：在无效查询集成到应用之前尽早捕获它们，从而减少运行时错误和 API 调用失败。
- 加快开发速度：支持快速测试和调试 GAQL 语句，而无需承担完整的 API 请求和响应周期开销。
- 了解 GAQL 限制：帮助开发者了解哪些字段兼容以及资源之间如何关联等复杂规则。
- 调试查询：在查询无效时提供具体的出错提示，通常比一般 API 错误更详细，有时还会建议有效的替代方案。
- 资源效率：避免因查询注定失败而进行不必要的 API 调用。
运作方式
查询验证器会根据 Google Ads API 的架构和 Google Ads 查询语言中定义的规则来解析您的 GAQL 查询。它使用元数据（其中大部分可从 GoogleAdsFieldService 访问）来执行检查，包括：
- 语法和结构：确保查询遵循正确的 GAQL 语法，包括正确使用和排列
SELECT、FROM、WHERE、ORDER BY、LIMIT和PARAMETERS等子句。 - 字段有效性：检查所有指定字段（资源、细分、指标）是否存在且拼写正确。
- 资源兼容性：验证
SELECT子句中选择的字段是否与FROM子句中指定的主要资源兼容。 - 细分和指标兼容性：确保在同一查询中一起使用的细分和指标彼此兼容，并且与
FROM子句中的资源兼容。 - 子句要求：验证规则，例如要求
ORDER BY子句中使用的字段和WHERE子句中使用的某些字段（例如细分）也必须存在于SELECT子句中。 - 运算符用法：检查
WHERE子句条件中运算符的使用是否正确。
如果查询有效，该工具会进行确认。如果发现问题，它会提供出错提示，帮助您查明问题，有时还会提供修复建议，例如针对给定指标的兼容资源。
开始使用
如需使用 Google Ads 查询验证器，请执行以下操作：
- 前往查询验证器。
- 输入 GAQL 查询。
- 点击验证查询按钮。
- 查看查询验证器微件下方显示的验证消息。 系统会显示一条成功消息，表明查询有效。否则，系统会显示一条描述问题的错误消息。出错提示会引导您更正查询。例如，字段不兼容错误可能会列出与您尝试查询的指标或细分兼容的备用资源。
如需详细了解 GAQL 概念和语法，请参阅 Google Ads 查询语言指南。如需以交互方式构建和测试 GAQL 查询，您还可以使用查询构建器和 API Explorer。