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

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

الحقول متاحة في 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