حقول فلاتر طلبات البحث المتاحة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اطّلِع على فلاتر طلبات البحث للاطّلاع على مرجع
حول بنية الفلتر، وراجِع أمثلة الفلاتر أدناه.
الحقول المتوافقة مع 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
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Supported query filter fields\n\nSee [Query filters](/workspace/admin/alertcenter/guides/query-filters) for reference\non filter syntax, and review the filter examples below.\n\nFields supported by `alerts.list`\n---------------------------------\n\n| Filter fields ||\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `alertId` | Should be used to filter alerts based on alert id. Corresponding value should be of type: `string`. |\n| `type` | Should be used to filter alerts based on alert type. Corresponding value should be of type: `string`. Possible values for this filter are listed in the [`Alert.type` field description](/workspace/admin/alertcenter/reference/rest/v1beta1/alerts#alert-types). |\n| `source` | Should be used to filter alerts based on alert source. Corresponding value should be of type: `string`. Possible values for this filter are listed in the [`Alert.type` field description](/workspace/admin/alertcenter/reference/rest/v1beta1/alerts#alert-types). |\n| `createTime` | Should be used to filter alerts based on alert creation time. Corresponding value should be of type: `string (`[Timestamp](/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)`; more specifically, an [RFC 3339](https://tools.ietf.org/html/rfc3339) date-time string, for example, `\"2018-01-01T00:00:00Z\"` |\n| `startTime` | Should be used to filter alerts based on alert start time. Corresponding value should be of type: `string (`[Timestamp](/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)`; more specifically, an [RFC 3339](https://tools.ietf.org/html/rfc3339) date-time string, for example, `\"2018-01-01T00:00:00Z\"` |\n| `endTime` | Should be used to filter alerts based on alert end time. Corresponding value should be of type: `string (`[Timestamp](/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)`; more specifically, an [RFC 3339](https://tools.ietf.org/html/rfc3339) date-time string, for example, `\"2018-01-01T00:00:00Z\"` |\n\n### List query examples\n\n- To query for all alerts created on or after April 5, 2018: \n `createTime \u003e= \"2018-04-05T00:00:00Z\"`\n- To query for all alerts from the source \"Gmail phishing\": \n `source:\"Gmail phishing\"`\n- To query for all alerts that started in 2017: \n `startTime \u003e= \"2017-01-01T00:00:00Z&\" AND startTime \u003c \"2018-01-01T00:00:00Z\"`\n- To query for all user-reported phishing alerts from the source \"Gmail phishing\": \n `type:\"User reported phishing\" source:\"Gmail phishing\"`\n\nFields supported by `alerts.feedback.list`\n------------------------------------------\n\n| Filter fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `alertId` | Should be used to filter alert feedback based on alert id. Corresponding value should be of type: `string`. Can be used to list feedback for selected alerts in one call when the '-' wildcard is used in request's `alertId`. |\n| `feedbackId` | Should be used to filter alert feedback based on feedback id. Corresponding value should be of type: `string`. |\n\n### Feedback list query examples\n\n- To query feedback of alerts with ids `alertId01` or `alertId02`: \n `alertId = alertId01 OR alertId = alertId02`\n- To query feedback of an alert `alertId01` with feedback id `feedbackId01`: \n `alertId = alertId01 AND feedbackId = feedbackId01`"]]
