حقول فلاتر طلبات البحث المتاحة

اطّلِع على فلاتر طلبات البحث للاطّلاع على مرجع حول بنية الفلتر، وراجِع أمثلة الفلاتر أدناه.

الحقول المتوافقة مع alerts.list

حقول الفلترة
alertId	يجب استخدامه لفلترة التنبيهات استنادًا إلى معرّف التنبيه. يجب أن تكون القيمة المقابلة من النوع: string.
type	يجب استخدامه لفلترة التنبيهات استنادًا إلى نوع التنبيه. يجب أن تكون القيمة المقابلة من النوع: string. القيم المحتملة لهذا الفلتر مُدرَجة في وصف حقل Alert.type.
source	يجب استخدامه لفلترة التنبيهات استنادًا إلى مصدر التنبيه. يجب أن تكون القيمة المقابلة من النوع: string. القيم المحتملة لهذا الفلتر مُدرَجة في وصف حقل Alert.type.
createTime	يجب استخدامه لفلترة التنبيهات استنادًا إلى وقت إنشائها. يجب أن تكون القيمة المقابلة من النوع: string (Timestamp format)، وعلى وجه التحديد، سلسلة RFC 3339 لتاريخ ووقت ، على سبيل المثال، "2018-01-01T00:00:00Z"
startTime	يجب استخدامه لفلترة التنبيهات استنادًا إلى وقت بدء التنبيه. يجب أن تكون القيمة المقابلة من النوع: string (Timestamp format)، وعلى وجه التحديد، سلسلة RFC 3339 لتاريخ ووقت ، على سبيل المثال، "2018-01-01T00:00:00Z"
endTime	يجب استخدامه لفلترة التنبيهات استنادًا إلى وقت انتهاء التنبيه. يجب أن تكون القيمة المقابلة من النوع: string (Timestamp format)، وعلى وجه التحديد، سلسلة RFC 3339 لتاريخ ووقت ، على سبيل المثال، "2018-01-01T00:00:00Z"

أمثلة على طلبات البحث

• للبحث عن جميع التنبيهات التي تم إنشاؤها في 5 نيسان (أبريل) 2018 أو بعد هذا التاريخ:
  createTime >= "2018-04-05T00:00:00Z"
• للبحث عن جميع التنبيهات من المصدر "التصيّد الاحتيالي في Gmail":
  source:"Gmail phishing"
• للبحث عن جميع التنبيهات التي بدأت في عام 2017:
  startTime >= "2017-01-01T00:00:00Z&" AND startTime < "2018-01-01T00:00:00Z"
• للبحث عن جميع تنبيهات التصيّد الاحتيالي التي أبلغ عنها المستخدمون من المصدر "تصيّد احتيالي في Gmail":
  type:"User reported phishing" source:"Gmail phishing"

الحقول المتوافقة مع alerts.feedback.list

حقول الفلترة
alertId	يجب استخدامه لفلترة ملاحظات التنبيهات استنادًا إلى معرّف التنبيه. يجب أن تكون القيمة المقابلة من النوع: string. يمكن استخدامها لعرض الملاحظات حول تنبيهات محدّدة في مكالمة واحدة عند استخدام العنصر النائب "-" في alertId للطلب.
feedbackId	يجب استخدامه لفلترة ملاحظات التنبيهات استنادًا إلى معرّف الملاحظات. يجب أن تكون القيمة المقابلة من النوع: string.

أمثلة على طلبات البحث في قائمة الملاحظات

• لإجراء طلب بحث عن الملاحظات بشأن التنبيهات التي تحمل المعرّفَين alertId01 أو alertId02:
  alertId = alertId01 OR alertId = alertId02
• لإجراء طلب بحث عن ملاحظات بشأن تنبيه alertId01 الذي يحمل معرّف الملاحظات feedbackId01:
  alertId = alertId01 AND feedbackId = feedbackId01