此页面由 Cloud Translation API 翻译。

Google Ads 查询语言

Google Ads 查询语言可查询以下内容的 Google Ads API：

使用

GoogleAdsService Search 或 SearchStream

GoogleAdsService 查询的结果是一个列表， GoogleAdsRow 个实例，每个 GoogleAdsRow 代表资源如果请求了任何属性或指标，则行还包含这些字段。如果请求了任何细分受众群，则响应还会针对每个细分资源元组额外显示一行。

有关中的可用字段和资源的元数据

GoogleAdsFieldService

此服务提供可查询字段的目录，其中包含有关其兼容性和类型的详细信息。

GoogleAdsFieldService 查询的结果是一个列表 GoogleAdsField 个实例，每个 GoogleAdsField，包含有关所请求字段的详细信息。

查询资源的特性

以下是对广告系列资源属性的基本查询，解释了返回广告系列 ID、名称和状态：

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

此查询按广告系列 ID 排序。每个生成的 GoogleAdsRow 将表示填充了选定字段（包括campaign 广告系列的 resource_name）。

要了解还有哪些其他字段可用于广告系列查询，请查阅 Campaign 参考文档。

查询指标

除了给定资源的选定属性之外，您还可以查询相关指标：

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

此查询仅过滤出处于“PAUSED”状态的广告系列，并且展示次数超过 1000 次，而按广告系列 ID 排序。每个生成的 GoogleAdsRow 将有一个 metrics 字段，其中填充了所选指标

如需查看可查询指标的列表，请参阅 Metrics 文档。

查询细分

除了给定资源的选定属性之外，您还可以查询相关细分受众群：

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

与查询指标类似，此查询仅过滤出符合以下条件的广告系列：状态为 PAUSED 且展示次数超过 1000；不过，此查询会按日期细分数据这会使每个表示广告系列的元组和日期 Segment 的 GoogleAdsRow。时间是请务必注意，细分会拆分选定的指标，并按每个指标是 SELECT 子句中的一部分。

如需查看可查询细分的列表，请参阅 Segments 文档。

查询相关资源的特性

在给定资源的查询中，您或许可以联接其他资源（如果有）。这些相关资源称为资源”。您可以通过选择一个属性。

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

此查询不仅会选择广告系列属性，还会提取相关的属性。每个生成的 GoogleAdsRow 表示一个 campaign 对象，该对象填充了选定的广告系列属性以及所选出价策略属性“bidding_strategy.name”。

如需了解哪些归因资源可用于广告系列查询，请参阅 Campaign 参考文档。

根据查询结果执行 Mutate 操作

查询给定资源时，您可以立即获取将结果作为对象进行修改，然后将它们发送回资源服务。以下是一个示例工作流程：

针对当前处于PAUSED状态且具有展示次数大于 1000。
从以下每个 GoogleAdsRow 的 campaign 字段中获取 Campaign 对象：响应。
将每个广告系列的状态从 PAUSED 更改为 ENABLED。
调用 CampaignService.MutateCampaigns 对修改后的广告系列进行更新。

字段元数据

发送到 GoogleAdsFieldService 的查询用于检索字段元数据。此信息可用于了解如何结合使用这些字段。由于数据可通过 API 获取，验证或构建查询所需的元数据，以便开发者因此以编程方式创建这里有典型的元数据查询：

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

您可以将此查询中的 <INSERT_RESOURCE_OR_FIELD> 替换为资源（例如 customer 或 campaign）或字段（例如 campaign.id、 metrics.impressions 或 ad_group.id）。

如需查看可查询字段的列表，请参阅 GoogleAdsField 文档。

代码示例

客户端库提供了一些有关如何使用 GoogleAdsService的 Google Ads 查询语言。基本操作文件夹包含例如 GetCampaigns、GetKeywords 和 SearchForGoogleAdsFields。 reporting 文件夹中有一个 GetKeywordStats 示例。

查询语法