フィルタしたレポート

新しい Search Ads 360 Reporting API をご利用いただけるようになりました。新しい API では、柔軟性の向上により、カスタム レポートを作成し、レポート作成のアプリケーションやプロセスにデータを統合することができます。詳しくは、新しい Search Ads 360 Reporting API への移行と使用についての記事をご覧ください。

デフォルトでは、レポートにはリクエストで指定された 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	列は、フィルタのリストのいずれかの値と完全に一致している必要があります。 リストデータ型（String list など）には有効ではありません。	可変
lessThan	列には、指定した値より小さい値が含まれている必要があります。 このフィルタを Boolean 列に指定すると、Search Ads 360 API は false を 0 の数値に変換し、true を 1 に変換します。このフィルタを String 列に指定すると、API は辞書順が比較されます。 リストデータ型（String list など）に対しては無効です。	1
greaterThan	列には、フィルタのリストにある値より大きい値が含まれている必要があります。 このフィルタを Boolean 列に指定すると、API は false を 0 の数値に変換し、true を 1 に変換します。このフィルタを String 列に指定すると、API は辞書順が比較されます。 リストデータ型（String list など）には有効ではありません。	1
lessThanOrEqual	列には、フィルタのリストにあるいずれかの値以下の値が含まれている必要があります。 このフィルタを Boolean 列に指定すると、API は false を 0 の数値に変換し、true を 1 に変換します。このフィルタを String 列に指定すると、API は辞書順が比較されます。 リストデータ型（String list など）には有効ではありません。	1
greaterThanOrEqual	列には、フィルタのリストにあるいずれかの値以上の値が含まれている必要があります。 このフィルタを Boolean 列に指定すると、API は false を 0 の数値に変換し、true を 1 に変換します。このフィルタを String 列に指定すると、API は辞書順が比較されます。 リストデータ型（String list など）には有効ではありません。	1
isNull	列は空でなければなりません。たとえば、キーワード レポートの keywordMaxCpc 列に isNull を指定した場合、レポートには、上限クリック単価が指定されていないキーワードのみが含まれます。	0
isNotNull	列には値が入っている必要があります。	0
startsWith	列は、フィルタのリストにある文字列のいずれかで始める必要があります。 String 列でのみ有効です。	可変
containsSubstring	列には、フィルタのリストで指定された文字列のすべてまたは一部が含まれている必要があります。 たとえば、containsSubstring フィルタに次の値を含めると、 ["ham", "cheese"] 次の値を持つ行が返されます。 hamburger cheeseburger ただし、次の値を含む行は返されません。 lobster roll lettuce high amplitude（high amplitude には部分文字列「h am」が含まれますが、スペースを含むすべての文字がフィルタによって評価されます） String 列でのみ有効です。	可変
doesNotContainSubstring	フィルタのリストにある文字列を列に含めることはできません。 たとえば、doesNotContainSubstring フィルタの値が ["ham", "cheese"] の場合、次の値を持つ行が返されます。 lobster roll lettuce ただし、次の値を含む行は返しません。 hamburger cheeseburger String 列でのみ有効です。	可変
containsElement	列には、フィルタのリストにある値が 1 つ以上含まれている必要があります。 リストデータ型の列（String list など）でのみ有効です。 たとえば、campaign レポートの場合、次の値を持つ containsElement フィルタ ["foo", "bar"] effectiveLabels 列に対してフィルタリングを行うと、foo、bar、またはその両方でラベル付けされたキャンペーンのみが返されます。	可変