기본적으로 보고서에는 요청에서 지정한 reportScope 내의 모든 데이터가 포함됩니다. 보고서에 기준 집합과 일치하는 데이터만 포함하려는 경우 보고서에 필터를 하나 이상 추가할 수 있습니다. 모든 필터를 충족하는 행만 반환됩니다.
예를 들어 대행사의 모든 키워드에 대한 보고서를 요청할 수 있습니다. 그런 다음 방문 페이지 URL이 www.example.com과 www.another-example.com으로 시작하는 키워드만 보고서에 표시되도록 필터를 지정할 수 있습니다.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
각 필터는 필터링할 열, 연산자, 지정된 열에 있어야 하는 값 목록을 지정합니다.
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
인지 여부를 나타냅니다.
필터 연산자
모든 필터는 대소문자를 구분합니다. 즉, 'www.Sprockets.com'이 있는 필터는 'www.sprockets.com'이 포함된 열과 일치하지 않습니다.
운영자 | 설명 | 지원되는 값 수 |
---|---|---|
equals |
열이 지정된 값과 정확하게 일치해야 합니다. | 1 |
notEquals |
열은 지정된 값과 일치하지 않아야 합니다. | 1 |
in |
열이 필터 목록에 있는 값 중 하나와 정확하게 일치해야 합니다.
목록 데이터 유형 (예: |
가변 |
lessThan |
열에는 지정된 값보다 작은 값이 포함되어야 합니다.
목록 데이터 유형 (예: |
1 |
greaterThan |
열에는 필터 목록의 값보다 큰 값이 포함되어야 합니다.
목록 데이터 유형 (예: |
1 |
lessThanOrEqual |
열에는 필터 목록의 값 중 하나 이하의 값이 포함되어야 합니다.
목록 데이터 유형 (예: |
1 |
greaterThanOrEqual |
열에는 필터 목록에 있는 값 중 하나 이상의 값이 포함되어야 합니다.
목록 데이터 유형 (예: |
1 |
isNull |
열은 비어 있어야 합니다. 예를 들어 키워드 보고서에서
keywordMaxCpc 열에 isNull 을 지정하면 보고서에 최대 CPC를
지정하지 않은 키워드만 포함됩니다.
|
0 |
isNotNull |
열에 값이 포함되어야 합니다. | 0 |
startsWith |
열은 필터 목록에 있는 문자열 중 하나로 시작해야 합니다.
|
가변 |
containsSubstring |
열에는 필터의 목록에 지정된 문자열 중 일부 또는 전체가 포함되어야 합니다.
예를 들어 값이
다음 값이 있는 행은 반환하지 않습니다.
|
가변 |
doesNotContainSubstring |
열은 필터의 목록에 있는 문자열을 포함할 수 없습니다.
예를 들어 값이 하지만 다음 값이 포함된 행은 반환하지 않습니다.
|
가변 |
containsElement |
열에는 필터 목록의 값이 하나 이상 포함되어야 합니다.
목록 데이터 유형 (예:
예를 들어 |
가변 |