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
ลําดับความสําคัญของการเข้าร่วมจากมากไปน้อยคือ ไม่ใช่ AND หรือ OR

ตัวอย่าง

ตัวอย่างตัวกรองด้านล่างนี้ โปรดทราบว่าช่องจริงที่รองรับอาจแตกต่างกันไปตาม API เวอร์ชันต่างๆ สําหรับคอลัมน์ตัวกรองที่พร้อมใช้งานใน v1beta1 โปรดดูที่นี่

หากต้องการค้นหาการแจ้งเตือนทั้งหมดที่สร้างในวันที่ 5 เมษายน 2018 เป็นต้นไป ให้ทําดังนี้
createTime >= "2018-04-05T00:00:00Z"

หากต้องการค้นหาการแจ้งเตือนทั้งหมดจากแหล่งที่มา "Gmail ฟิชชิง"
source="Gmail phishing"

วิธีค้นหาการแจ้งเตือนทั้งหมดจากแหล่งที่มาที่ขึ้นต้นด้วย "Gmail":
source:"Gmail"

วิธีค้นหาการแจ้งเตือนทั้งหมดที่เริ่มต้นในปี 2017:
startTime >= "2017-01-01T00:00:00Z" AND startTime < "2018-01-01T00:00:00Z"

วิธีการค้นหาการแจ้งเตือนทั้งหมดที่เริ่มต้นในปี 2017:

รายงาน
การค้นหาทั้งเรื่องฟิชชิงและการอ้างอิง type="User reported phishing" source="Gmail phishing"