排序及限制結果

將結果排序

您可以使用 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 等)。