对结果进行排序和限制结果数量

订单结果

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

FieldName ('ASC' | 'DESC')?

如果您没有在字段名称后面指定 ASCDESC,则 Reporting API 会默认设置为 ASC

以下 ORDER BY 子句会按展示次数降序和商品优惠 ID 升序对效果报告进行排序:

ORDER BY metrics.impressions DESC, segments.offer_id ASC

未选择的指标或细分不支持“ORDER BY”。

限制结果数量

您可以使用 LIMIT 子句限制返回的结果总数。结合使用结果排序和结果排序,您可以生成“前 N”报告,例如,包含过去 30 天内展示次数最高的五种产品的报告:

示例

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-31'
ORDER BY metrics.impressions DESC
LIMIT 5;

如果不选择指标,则不允许对metrics进行过滤(WHERE 子句)。