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 日當天或之後建立的所有快訊：



如何查詢來源為「Gmail 網路詐騙」的所有快訊：
source="Gmail phishing"

如何查詢從「Gmail」開頭的所有來源快訊：
source:"Gmail"

查詢從 2017 年開始傳送的所有快訊：網路詐騙郵件
和所有網路詐騙郵件來源：