排序及限制結果

排序結果

您可以使用 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 天內曝光次數最高的 5 個廣告活動的報表：

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 等)