Method: alerts.list

يسرد التنبيهات.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

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

المعلمات
customerId

string

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

integer

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

string

اختياريّ. رمز مميّز يحدّد صفحة النتائج التي يجب أن يعرضها الخادم. إذا كانت فارغة، تبدأ عملية تكرار جديدة. لمواصلة تكرار العملية، عليك ضبط القيمة من حقل nextPageToken في ListAlertsResponse السابق.
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

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