排序及限制結果

將結果排序

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

FieldName ('ASC' | 'DESC')?

如果在欄位名稱後面沒有指定 ASCDESC,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.datesegments.weeksegments.monthsegments.quartersegments.year
  • 任一訊息類型的欄位,但基本類型除外 (例如:Int64Value、StringValue 等)
  • 在任一訊息類型的重複欄位屬性中,但基本屬性除外 (例如:Int64Value、StringValue 等)