이 페이지는 Cloud Translation API를 통해 번역되었습니다.

필터링

filters 쿼리 문자열 매개변수는 애드센스 관리 API 보고서에 반환되는 데이터를 제한합니다. filters 매개변수를 사용하는 경우 필터링할 측정기준과 필터 표현식을 차례로 입력합니다.

필터링된 쿼리는 결과에 포함되는 행을 제한합니다. 결과의 각 행이 필터와 비교하여 테스트됩니다. 필터가 일치하면 행이 유지되고 일치하지 않으면 행이 삭제됩니다.

URL 인코딩: 클라이언트 라이브러리는 필터 연산자를 자동으로 인코딩합니다. 하지만 프로토콜에 직접 요청하는 경우 아래 표에 표시된 대로 필터 연산자를 명시적으로 인코딩해야 합니다.
필터링 우선순위: 필터링은 측정기준이 집계되기 전에 실행되므로 반환된 측정항목은 관련 측정기준의 합계만 나타냅니다.

필터 구문

단일 필터는 다음 형식을 사용합니다.

name operator expression

이 구문에서 각 항목은 다음과 같습니다.

보고되는 측정항목에 적용되는 모든 측정기준을 필터로 사용할 수 있지만 날짜 관련 측정기준 (DATE, WEEK, MONTH)은 예외입니다. 날짜별로 필터링하려면 대신 보고서의 기간을 지정합니다.

필터 연산자에는 두 가지가 있습니다. 연산자가 URL 쿼리 문자열에 포함되려면 URL로 인코딩되어야 합니다.

운영자	설명	URL 인코딩 형식	예
`==`	일치검색	`%3D%3D`	국가명이 Canada인 측정항목을 집계합니다. `filters=COUNTRY_NAME%3D%3DCanada`
`=@`	하위 문자열 포함	`%3D@`	국가 이름에 United가 포함된 측정항목을 집계합니다. 예를 들어 United States 및 United Kingdom이 여기에 해당합니다. `filters=COUNTRY_NAME%3D@United`

필터 표현식에는 몇 가지 중요한 규칙이 있습니다.

URL 예약 문자 - &와 같은 문자는 일반적인 방식으로 URL 인코딩해야 합니다. 클라이언트 라이브러리에서 이 작업을 처리하므로 프로토콜을 직접 호출하는 경우에만 이 인코딩에 대해 신경 쓰면 됩니다.
예약 문자 - 쉼표와 백슬래시는 표현식에 표시될 때 백슬래시로 이스케이프 처리되어야 합니다.
- 백슬래시 \\
- 쉼표 \,

참고: 이중 이스케이프 처리를 방지하려면 쉼표 앞에 백슬래시를 이스케이프 처리해야 합니다.

OR 및 AND 불리언 로직을 사용하여 필터를 결합할 수 있습니다.

필터 표현식에 쉼표 (,)를 사용하여 OR 논리를 정의합니다.

예: (각각을 URL 인코딩해야 함)

국가 코드가 미국 또는 영국 중 하나임:
COUNTRY_CODE==US,COUNTRY_CODE==UK

AND 논리는 여러 필터 매개변수를 제공하여 실행되며, 클라이언트 라이브러리에서 일련의 필터 배열을 제공하는 것으로 해석됩니다.

예:

국가 코드가 US이고 제품 코드가 AFC인 경우:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC

하나의 표현식에 AND 및 OR 로직을 결합할 수 있습니다.

참고: 모든 필터가 하나의 AND 논리 표현식으로 결합되기 전에는 각 필터가 개별적으로 평가됩니다.

예:

국가 코드가 (US 또는 UK)이고 제품 코드가 AFC인 경우:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC