결과 순서 지정 및 제한

Google Ads 쿼리 언어를 사용하면 ORDER BY 및 LIMIT 절을 사용하여 쿼리 응답에서 반환된 행을 정렬하고 제한할 수 있습니다.

결과 정렬

쉼표로 구분된 하나 이상의 다음 시퀀스로 구성된 ORDER BY 절을 사용하여 응답의 행 순서를 지정할 수 있습니다.

FieldName (ASC | DESC)?

필드 이름 뒤에 ASC 또는 DESC를 지정하지 않으면 Google Ads API는 기본적으로 ASC를 사용합니다. ORDER BY 절을 완전히 생략하면 반환된 행의 순서는 비확정적입니다.

다음 ORDER BY 절은 캠페인 수준 보고서를 노출수 내림차순 및 캠페인 이름 오름차순으로 정렬합니다.

ORDER BY metrics.impressions DESC, campaign.name ASC
  • 선택되지 않은 리소스의 속성별
  • 선택되지 않은 측정항목
  • 선택되지 않은 세그먼트
  • 다음 유형의 필드의 경우:
    • MESSAGE
    • 반복 필드
    • 반복되는 입력란의 속성

결과 수 제한

양의 정수 (1 이상, LIMIT 0는 유효하지 않음)와 함께 LIMIT 절을 사용하여 반환되는 결과의 총수를 제한할 수 있습니다. 이 기능을 결과 순서 지정과 결합하면 지난 30일 동안 노출수가 가장 많은 5개 캠페인이 포함된 보고서와 같은 '상위 N개' 보고서를 생성할 수 있습니다.

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

검색 결과 필터링

WHERE 필터를 ORDER BY 및 LIMIT와 결합할 때는 다음 필터링 제한사항에 유의하세요.

  • '핵심' 날짜 세그먼트 필드 (segments.date, segments.week, segments.month, segments.quarter, segments.year)를 제외하고 세그먼트를 선택하지 않고는 필터링이 허용되지 않습니다.
  • 합성 MESSAGE 필드에서는 직접 필터링이 허용되지 않습니다 (Int64Value, StringValue와 같은 기본 래퍼 메시지 제외). 대신 기본 스칼라 (int64, string, bool) 또는 enum 하위 필드를 기준으로 필터링하세요.
  • 반복 필드의 복합 MESSAGE 속성에 대한 필터링은 허용되지 않습니다. 기본 스칼라 (int64, string, bool), enum 또는 기본 래퍼 하위 필드만 필터링할 수 있습니다.
이전
대소문자 구분