Query filters

在提供过滤功能的 API 请求中使用以下查询过滤规范。过滤条件字符串必须指定为表达式或表达式列表。

简单表达式

必须使用以下语法指定过滤条件：

表达式的通用形式为：

<expr> ::= <field> <operator> <value>

  • <field>的会员级别为string。当 <field> 包含空格或冒号时，必须用英文双引号括起来。
  • <operator> 可以是等式或关系运算符，并遵循以下规范：
    等式运算符 "=" 仅为字符串字段定义。
    前缀字符串运算符 ":" 仅为字符串字段定义。
    仅为时间戳字段定义关系运算符 "<" | ">" | "<=" | ">="。
  • 提供的 <value> 应为 string，它可能采用 Timestamp 格式，具体取决于 <field>。当 <value> 包含空格或冒号时，必须用英文双引号括起来。

表达式列表

表达式可以联接起来形成更复杂的查询。BNF 规范如下：

<exprList> ::= <expr> |
<exprList> <conjunction> <expr> |
<negation> <expr>
<conjunction> ::= "AND" | "OR" | ""
<negation> ::= "NOT"
使用空字符串作为隐含的 AND。
联接操作的优先级从高到低依次为 NOT、AND、OR。

示例

以下是一些过滤器示例。请注意，所支持的实际字段可能会因 API 的不同版本而异。如需了解 v1beta1 中提供的过滤条件列，请点击此处。

要查询在 2018 年 4 月 5 日当天或之后创建的所有提醒，请执行以下操作：
createTime >= "2018-04-05T00:00:00Z"

要查询来源为“Gmail 钓鱼式攻击”的所有提醒，请执行以下操作：
source="Gmail phishing"

要查询以“Gmail”开头的来源的所有提醒，请按以下步骤操作：
source:"Gmail"

要查询在 2017 年开始的所有提醒，请执行以下操作：



网上诱骗通知：