过滤后的报告

新版 Search Ads 360 Reporting API 现已发布。这一新 API 提供 可以更灵活地生成自定义报告并将数据整合到您的报告应用程序中 和进程。详细了解如何迁移到和使用新版 Search Ads 360 报告 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 此列必须为空。例如，如果您指定 isNull 关键字报表中的 keywordMaxCpc 列时， 将仅包含未指定最高每次点击费用的关键字。 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

但不会返回具有以下值的行：
汉堡汉堡
奶酪汉堡

仅对 String 列有效。

不定额
containsElement

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

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

不定额