排序及限制結果數量

排序結果

您可以使用 ORDER BY 子句指定回應中的資料列順序，該子句包含一或多個以半形逗號分隔的序列：

FieldName ('ASC' | 'DESC')?

如果您在欄位名稱後方未指定 ASC 或 DESC，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;

注意： 查詢擷取的資料列數量上限為 1000 個，即使上限較高也一樣。您必須使用 pageToken 發出連續要求，才能取得其餘結果。詳情請參閱分頁指南。

如未選取metrics，就無法使用篩選 (WHERE 子句) 功能。