过滤后的报告

新版 Search Ads 360 Reporting API 现已发布。这个新 API 让您可以更灵活地生成自定义报告，并将数据整合到您的报告应用和流程中。您可以详细了解如何迁移到和使用新版 Search Ads 360 Reporting API。

默认情况下，您的报告将包含您的请求指定的 reportScope 中的所有数据。如果您希望报告仅包含与一组条件匹配的数据，则可以向报告添加一个或多个过滤条件。系统只会返回满足所有过滤条件的行。

例如，您可以请求为代理机构中的所有关键字生成一份报表。然后，您可以指定过滤条件，以便只有着陆页网址以 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"]
cheeseburger
hamburger

但不会返回具有以下值的行：
lobster roll
lettuce
high amplitude（high amplitude 包含子字符串“h am”，但过滤器会评估所有字符（包括空格））

仅对 String 列有效。

 变量
doesNotContainSubstring

该列不得包含过滤器列表中的任何字符串。

例如，值为
["ham", "cheese"]
的 doesNotContainSubstring 过滤条件将返回具有以下值的行：
lobster roll
lettuce

但不会返回具有以下值的行：
hamburger
cheeseburger

仅对 String 列有效。

 变量
containsElement

该列必须至少包含过滤器列表中的一个值。仅对具有列表数据类型（例如 String list）的列有效。

例如，在 campaign 报告中，如果 containsElement 过滤条件的值为：
["foo", "bar"]
对 effectiveLabels 列进行过滤，则只会返回带有 foo 和/或 bar 标签的广告系列。

 变量