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。
查询验证器
点击输入或修改查询后，系统会打开查询验证器。使用查询验证器验证查询的语法。通过查询构建器完全构建的任何查询都已具有正确的语法，但如果您熟悉要查询的资源，则可以使用查询验证器快速输入查询并检查其有效性。如需详细了解该工具，请参阅查询验证器。