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 โปรดดูที่นี่

วิธีค้นหาการแจ้งเตือนทั้งหมดที่สร้างขึ้นในวันที่ 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"

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