訂單結果

您可以使用 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 等)