Query filters

استخدِم مواصفات فلاتر طلبات البحث الواردة في طلبات البيانات من واجهة برمجة التطبيقات التي توفّر إمكانات الفلترة. يجب تحديد سلسلة الفلتر كتعبير أو قائمة من التعبيرات.

تعبيرات بسيطة

يجب تحديد الفلاتر باستخدام القواعد النحوية التالية:

ويكون للتعبير الشكل العام:

<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 وOR.

أمثلة

وفي ما يلي بعض الأمثلة على الفلاتر. يُرجى العِلم بأن الحقول الفعلية المتوافقة قد تختلف بين الإصدارات المختلفة من واجهة برمجة التطبيقات. بالنسبة إلى أعمدة الفلاتر المتاحة في v1beta1، يمكنك الاطّلاع هنا.

لإجراء طلب بحث عن جميع التنبيهات التي تم إنشاؤها في 5 نيسان (أبريل) 2018 أو بعده:
createTime >= "2018-04-05T00:00:00Z"

للاستعلام عن جميع التنبيهات الواردة من المصدر "يتعلّم من Gmail: