ใช้ข้อกําหนดตัวกรองการค้นหาด้านล่างในคําขอ API ที่มีความสามารถในการกรอง ต้องระบุสตริงตัวกรองเป็นนิพจน์หรือรายการนิพจน์
นิพจน์ง่ายๆ
ต้องระบุตัวกรองโดยใช้ไวยากรณ์ต่อไปนี้
นิพจน์มีรูปแบบทั่วไปดังนี้
<expr> |
::= |
<field> <operator> <value> |
<field>
เป็นstring
เมื่อ<field>
มีช่องว่างหรือโคลอนต้องใส่เครื่องหมายคําพูดคู่<operator>
อาจเป็นโอเปอเรเตอร์แบบเท่ากับหรือสัมพันธ์ก็ได้ และเป็นไปตามข้อกําหนดต่อไปนี้
โอเปอเรเตอร์ความเท่าเทียมกัน"="
มีไว้สําหรับช่องสตริงเท่านั้น
โอเปอเรเตอร์การจับคู่คํานําหน้า":"
กําหนดไว้สําหรับช่องสตริงเท่านั้น
โอเปอเรเตอร์ความสัมพันธ์"<" | ">" | "<=" | ">="
กําหนดไว้สําหรับช่องการประทับเวลาเท่านั้น
<value>
ที่ระบุควรเป็นstring
ซึ่งอาจอยู่ในรูปแบบTimestamp
โดยขึ้นอยู่กับ<field>
เมื่อ<value>
มีช่องว่างหรือโคลอน จะต้องใส่เครื่องหมายคําพูดคู่
รายการนิพจน์
เราอาจรวมนิพจน์เข้าด้วยกันเพื่อสร้างคําค้นหาที่ซับซ้อนมากขึ้น ข้อกําหนดของ BNF คือ
<exprList> |
::= |
<expr> |
|
<conjunction> |
::= |
"AND" | "OR" | "" |
<negation> |
::= |
"NOT" |
ลําดับความสําคัญของการเข้าร่วมจากมากไปน้อยคือ ไม่ใช่ 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"