결과 순서 지정 및 제한

결과 정렬

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 등)를 사용합니다.