Method: alerts.list

عرض التنبيهات

طلب HTTP

GET https://alertcenter.googleapis.com/v1beta1/alerts

يستخدم عنوان URL بنية gRPC Transcode.

معامِلات طلب البحث

المَعلمات
customerId

string

اختياريّ. المعرِّف الفريد لحساب Google Workspace الخاص بالعميل الذي ترتبط به التنبيهات. يجب أن يحتوي customerId على الحرف الأولي "C" (مثل 046psxkn). ويتم استنتاجه من هوية المتصل إذا لم يتم تقديمه. العثور على الرقم التعريفي للعميل

pageSize

integer

اختياريّ. حجم الصفحة المطلوب قد يعرض الخادم عدد عناصر أقل من المطلوب. وفي حال عدم تحديد نوع الخادم، يختار الخادم قيمة تلقائية مناسبة.

pageToken

string

اختياريّ. رمز مميز يحدّد صفحة نتائج يجب أن يعرضها الخادم وفي حال ترك هذا الحقل فارغًا، يبدأ تكرار التكرار. لمواصلة التكرار، انتقِل القيمة من الحقل nextPageTokenListAlertsResponse السابق.

filter

string

اختياريّ. سلسلة طلب بحث لفلترة نتائج التنبيه. لمزيد من التفاصيل، يُرجى الاطّلاع على فلاتر طلبات البحث وحقول فلاتر طلبات البحث المتوافقة.

orderBy

string

اختياريّ. نظام ترتيب نتائج القائمة وإذا لم يتم تحديد نتائج محددة، قد يتم عرضها بترتيب عشوائي. يمكنك ترتيب النتائج تنازليًا استنادًا إلى الطابع الزمني لإنشاء المحتوى باستخدام orderBy="createTime desc". الترتيب الحالي هو createTime asc وcreateTime desc وupdateTime desc.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة رد لطلب عرض تنبيه التنبيه.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
الحقول
alerts[]

object (Alert)

قائمة التنبيهات.

nextPageToken

string

الرمز المميز للصفحة التالية. إذا لم يكن الحقل فارغًا، يشير ذلك إلى توفُّر المزيد من التنبيهات التي تتطابق مع طلب البيانات، ويمكن استخدام هذه القيمة في ListAlertsRequest لاحقًا للحصول على التنبيهات من النتيجة الأخيرة لمكالمة القائمة الحالية.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/apps.alerts

لمزيد من المعلومات، اطّلِع على دليل التفويض.