在提供过滤功能的 API 请求中使用以下查询过滤规范。过滤条件字符串必须指定为表达式或表达式列表。
简单表达式
必须使用以下语法指定过滤条件:
表达式的通用形式为:
<expr> |
::= |
<field> <operator> <value> |
<field>
的会员级别为string
。当<field>
包含空格或冒号时,必须用英文双引号括起来。<operator>
可以是等式或关系运算符,并遵循以下规范:
等式运算符"="
仅为字符串字段定义。
前缀字符串运算符":"
仅为字符串字段定义。
仅为时间戳字段定义关系运算符"<" | ">" | "<=" | ">="
。
- 提供的
<value>
应为string
,它可能采用Timestamp
格式,具体取决于<field>
。当<value>
包含空格或冒号时,必须用英文双引号括起来。
表达式列表
表达式可以联接起来形成更复杂的查询。BNF 规范如下:
<exprList> |
::= |
<expr> |
|
<conjunction> |
::= |
"AND" | "OR" | "" |
<negation> |
::= |
"NOT" |
联接操作的优先级从高到低依次为 NOT、AND、OR。
示例
以下是一些过滤器示例。请注意,所支持的实际字段可能会因 API 的不同版本而异。如需了解 v1beta1
中提供的过滤条件列,请点击此处。
要查询在 2018 年 4 月 5 日当天或之后创建的所有提醒,请执行以下操作:
createTime >= "2018-04-05T00:00:00Z"
要查询来源为“Gmail 钓鱼式攻击”的所有提醒,请执行以下操作:
source="Gmail phishing"
要查询以“Gmail”开头的来源的所有提醒,请按以下步骤操作:
source:"Gmail"
要查询在 2017 年开始的所有提醒,请执行以下操作:
网上诱骗通知: