デフォルトでは、レポートにはリクエストで指定された reportScope 内のすべてのデータが含まれます。一連の条件に一致するデータのみをレポートに含める場合は、レポートに 1 つ以上のフィルタを追加します。すべてのフィルタを満たす行のみが返されます。
たとえば、代理店のすべてのキーワードのレポートをリクエストできます。その後、ランディング ページ 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 を指定した場合、レポートには、上限クリック単価が指定されていないキーワードのみが含まれます。 |
0 |
isNotNull |
列には値が入っている必要があります。 | 0 |
startsWith |
列は、フィルタのリストにある文字列のいずれかで始める必要があります。
|
可変 |
containsSubstring |
列には、フィルタのリストで指定された文字列のすべてまたは一部が含まれている必要があります。
たとえば、
ただし、次の値を含む行は返されません。
|
可変 |
doesNotContainSubstring |
フィルタのリストにある文字列を列に含めることはできません。
たとえば、 ただし、次の値を含む行は返しません。
|
可変 |
containsElement |
列には、フィルタのリストにある値が 1 つ以上含まれている必要があります。
リストデータ型の列(
たとえば、 |
可変 |