排序及限制結果

您可以使用 Google Ads 查詢語言，透過 ORDER BY 和 LIMIT 子句，排序及限制查詢回應中傳回的資料列。

排序結果

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

FieldName (ASC | DESC)?

如果未在欄位名稱後方指定 ASC 或 DESC，Google Ads API 會預設為 ASC。如果完全省略 ORDER BY 子句，傳回的資料列順序不具確定性。

下列 ORDER BY 子句會依曝光次數遞減和廣告活動名稱遞增排序廣告活動層級報表：

ORDER BY metrics.impressions DESC, campaign.name ASC
  • 依未選取資源的屬性
  • 依未選取的指標
  • 依未選取的區隔
  • 下列類型的欄位：
    • MESSAGE
    • 重複欄位
    • 重複欄位的屬性

限制結果數量

您可以使用 LIMIT 子句搭配正整數 (1 或更大；LIMIT 0 無效)，限制傳回的結果總數。搭配結果排序功能，您就能產生「前 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

篩選結果

將 WHERE 篩選器與 ORDER BY 和 LIMIT 結合時，請注意下列篩選限制：

  • 除非選取區隔，否則無法篩選區隔，但「核心」日期區隔欄位 (segments.date、segments.week、segments.month、segments.quarter 和 segments.year) 除外。
  • 您無法直接篩選複合 MESSAGE 欄位 (Int64Value 和 StringValue 等原始包裝函式訊息除外)，請改為篩選原始純量 (int64、string、bool) 或列舉子欄位。
  • 重複欄位的複合 MESSAGE 屬性不支援篩選功能，只能篩選原始純量 (int64、string、bool)、列舉或原始包裝函式子欄位。
上一頁
區分大小寫