Google Ads API is returning to beta status. Please read our blog post for more details.

排序和限制结果

排序结果

您可以使用 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 等基元除外。