排序及限制結果

將結果排序

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

FieldName ('ASC' | 'DESC')?

若未在欄位名稱後方指定 ASC 或 DESC，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.date、segments.week、segments.month、segments.quarter 和 segments.year。
• 顯示在任何訊息類型的欄位，但基元除外 (例如Int64Value、StringValue 等)。
• 用於任何訊息類型的重複欄位屬性 (基本除外，例如Int64Value、StringValue 等)。