استخدِم مواصفات فلاتر طلبات البحث أدناه في طلبات واجهة برمجة التطبيقات التي توفّر إمكانيات الفلترة. يجب تحديد سلسلة الفلتر كتعبير أو قائمة من التعبيرات.
تعبيرات بسيطة
يجب تحديد الفلاتر باستخدام القواعد النحوية التالية:
ويكون التعبير بالشكل العام:
<expr> |
::= |
<field> <operator> <value> |
<field>string. عندما يحتوي<field>على مسافة أو علامة نقطتين، يجب وضعهما بين علامتي اقتباس.- يمكن أن تكون الدالة
<operator>عوامل تساوي المساواة أو العلاقة، وتتّبع المواصفات على النحو التالي:
يتم تحديد عامل المساواة"="لحقول السلسلة فقط.
يتم تحديد عامل مطابقة البادئة":"لحقول السلسلة فقط.
يتم تحديد عوامل التشغيل الارتباطية"<" | ">" | "<=" | ">="لحقول الطابع الزمني فقط.
- يجب أن يكون تنسيق
<value>المقدَّمstringوقد يكون بتنسيقTimestampاستنادًا إلى<field>. عندما تحتوي السمة<value>على مسافة أو نقطتين، يجب وضعها بين علامتَي اقتباس.
قوائم التعبيرات
يمكن ضم التعبيرات لإنشاء استعلام أكثر تعقيدًا. في ما يلي مواصفات BNF:
<exprList> |
::= |
<expr> |
|
<conjunction> |
::= |
"AND" | "OR" | "" |
<negation> |
::= |
"NOT" |
تكون أولوية عمليات الدمج، من الأعلى إلى الأدنى، هي NOT وAND وOR.
أمثلة
في ما يلي بعض الأمثلة على الفلاتر. يُرجى العِلم أنّ الحقول الفعلية المتوافقة قد تختلف بين الإصدارات المختلفة لواجهة برمجة التطبيقات. للاطّلاع على أعمدة الفلاتر المتوفّرة في 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"