Google Ads 查询构建器是一款互动式工具，旨在帮助您使用 Google Ads 查询语言 (GAQL) 以互动方式构建和验证查询。无论您是 GAQL 新手还是经验丰富的用户，查询构建器都可以简化从 Google Ads API 中提取所需确切数据的过程。
福利
- 易用性： 简化了编写 GAQL 查询的过程，无需熟悉特定语法和可用字段。
- 可探索性： 帮助探索和查找 Google Ads API 数据模型中的可用资源、字段、细分和指标。
- 减少错误： 通过提供结构化界面和有效选项的下拉菜单，有助于防止语法错误和错别字，确保生成的查询有效。
- 加快查询构建速度： 通过自动生成查询字符串来加快开发过程。
- 验证： 该工具与 API Explorer 和查询验证器相关联，可在执行前根据 API 规则检查查询。
运作方式
Google Ads 查询构建器提供了一个用户友好的界面，可直观地组装 GAQL 查询。以下是基本工作流程：
- 选择资源： 首先，从要查询的版本的
“参考”标签页中选择主要资源。此资源将位于
FROM子句中。资源表示 Google Ads 中的实体，例如campaign、ad_group或keyword_view。构建器会列出所有可用资源。 - 选择字段： 选择资源后，该工具会显示所有可选择的字段，包括与该资源及其归因（隐式可联接）资源相关的属性、细分和指标。您可以勾选复选框，将字段添加到
SELECT子句中。在您进行选择时，该工具会动态生成相应的 GAQL 查询字符串，显示任何错误，并过滤掉不兼容的字段组合。 - 应用过滤条件： 您可以添加
WHERE子句条件来过滤结果。构建器可帮助您选择字段、运算符和值，确保语法正确。 - 对结果排序： 使用
ORDER BY子句指定排序顺序。 - 设置限制： 添加
LIMIT子句以控制返回的结果数量。 - 验证：该工具本身会引导您使用有效的字段 组合，但也会链接到API Explorer，以便您 根据自己的账号数据测试查询。此外，还有一个单独的 查询验证器，您可以在其中粘贴并检查 手动编写的 GAQL 查询。
- 导出： 对查询感到满意后，将经过测试且语法正确的 GAQL 字符串复制并粘贴到
GoogleAdsService.Search或SearchStream客户端请求中。
构建器会确保所选字段、细分和指标兼容，并且可以在单个查询中一起使用，同时引用 Google Ads API 的底层元数据。
开始使用
您可以通过两种方式访问查询构建器。一种方式是通过报告参考文档中的特定页面，另一种方式是从查询构建器概览页面进行探索。
从报告参考文档中
从查询构建器概览页面中
前往报告参考文档的“查询构建器 ”部分，然后选择要 探索的资源。
与其他工具集成
查询构建器与 Google Ads API 开发者工具包中的其他工具集成。您可以将查询构建器中构建的查询拿到 API Explorer 中进行测试，或使用查询验证器对其进行验证。
API Explorer
构建查询后，点击 Try in API Explorer （在 API Explorer 中试用）即可在 API Explorer 中打开查询。您的查询将自动填充到请求正文中，然后您可以针对自己的账号数据运行查询来测试查询。如需详细了解该工具，请参阅 API Explorer。
查询验证器
点击输入或修改查询 后，系统会打开查询验证器。使用查询验证器验证查询的语法。完全通过查询构建器构建的任何查询都将具有正确的语法，但如果您熟悉要查询的资源，查询验证器将提供一种快速输入查询并检查其有效性的方法。如需详细了解该工具，请参阅 查询验证器。