默认情况下,您的报告将包含您的请求指定的 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 |
该列必须与过滤器列表中的某个值完全匹配。
不适用于列表数据类型(例如 |
变量 |
lessThan |
该列包含的值必须小于指定的值。
如果您为 不适用于列表数据类型(例如 |
1 |
greaterThan |
该列包含的值必须大于过滤器列表中某个值。
如果为
不适用于列表数据类型(例如 |
1 |
lessThanOrEqual |
该列包含的值必须小于或等于过滤条件列表中的某个值。
如果为
不适用于列表数据类型(例如 |
1 |
greaterThanOrEqual |
该列包含的值必须大于或等于过滤条件列表中的某个值。
如果为
不适用于列表数据类型(例如 |
1 |
isNull |
该列必须为空。例如,如果您为关键字报告中的 keywordMaxCpc 列指定 isNull ,则该报告将只包含未指定最高每次点击费用的关键字。 |
0 |
isNotNull |
该列必须包含值。 | 0 |
startsWith |
列必须以过滤器列表中的某个字符串开头。
仅对 |
变量 |
containsSubstring |
该列必须包含过滤器列表中指定的某个字符串的全部或部分内容。
例如,包含值
但不会返回具有以下值的行:
仅对 |
变量 |
doesNotContainSubstring |
该列不得包含过滤器列表中的任何字符串。
例如,值为 但不会返回具有以下值的行:
仅对 |
变量 |
containsElement |
该列必须至少包含过滤器列表中的一个值。仅对具有列表数据类型(例如
例如,在 |
变量 |