排序和限制结果

排序结果

您可以使用 ORDER BY 子句指定响应中的行顺序,该子句由一个或多个以英文逗号分隔的以下序列组成:

FieldName ('ASC' | 'DESC')?

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

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

ORDER BY metrics.impressions DESC, campaign.name ASC

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

  • 未选定资源的属性
  • 未选定的指标
  • 未选定的细分
  • 对于以下类型的字段:
    • 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.datesegments.weeksegments.monthsegments.quartersegments.year
  • 除基元以外的任何消息类型的字段(例如:Int64Value、StringValue 等)
  • 任何消息类型的重复字段(基元除外,例如: Int64Value、StringValue 等)