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 操作

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

  1. 针对当前处于PAUSED状态且具有 展示次数大于 1000。
  2. 从以下每个 GoogleAdsRow 的 campaign 字段中获取 Campaign 对象： 响应。
  3. 将每个广告系列的状态从 PAUSED 更改为 ENABLED。
  4. 调用 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 示例。

下一页
查询语法