將結果排序
您可以使用 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 等)