排序和限制结果

排序结果

您可以使用 ORDER BY 子句指定响应中的行顺序， 它由一个或多个以逗号分隔的序列组成：

FieldName ('ASC' | 'DESC')?

如果您没有在字段名称的后面指定 ASC 或 DESC，那么 Google Ads API 将默认使用 ASC。

以下 ORDER BY 子句按降序对广告系列级报告进行排序 展示次数和按升序排列的广告系列名称：

ORDER BY metrics.impressions DESC, campaign.name ASC

不允许按以下内容进行排序：

• 未选定资源的属性
• 未选定的指标
• 未选定的细分
• 对于以下类型的字段： <ph type="x-smartling-placeholder">
  </ph>
  • MESSAGE
  • 重复字段
  • 重复字段的属性

限制结果数量

您可以使用 LIMIT 子句限制返回的结果总数。 结合结果排序，您可以生成“前 N 个”报告， 例如，包含展示次数最高的五个广告系列的报告 过去 30 天内：

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

不允许对以下内容进行过滤：

• 未选择细分（“核心”细分除外）日期细分字段。
  • 核心日期细分字段包括 segments.date、segments.week、 segments.month、segments.quarter 和 segments.year。
• 任何消息类型的字段，但 Int64Value、StringValue 等基元除外。
• 任何消息类型的重复字段的属性，但 Int64Value、StringValue 等基元除外。