訂單結果
您可以使用 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 等)