نظرة عامة

تتيح لك Alert Center API إدارة التنبيهات التي تؤثّر في نطاقك. التنبيه هو تحذير من مشكلة أمان محتملة رصدها Google. تتضمّن التنبيهات المعلومات التالية:

• مصدر التنبيه
• اسم التنبيه
• الوقت الذي حدث فيه هذا التنبيه
• بيانات محدّدة مرتبطة بهذا التنبيه

يمكن لمشرفي النطاق المسموح به رؤية التنبيهات وإدارتها يدويًا من وحدة تحكّم المشرف في Google. تسمح واجهة Alert Center API للتطبيقات التي تنشئها باسترداد بيانات التنبيه وتعليقات التنبيهات. يمكن أن تُنشئ واجهة برمجة التطبيقات أيضًا تعليقات إشعارات إخبارية للتنبيهات الحالية.

على سبيل المثال، يمكن لتطبيق المراقبة استخدام Alert Center API لاسترداد أحدث التنبيهات لنطاق، وتحديد أولويته، ثم إرسال إشعارات إلى مؤسستك. بعد أن يردّ فريقك على التنبيه، يمكن للتطبيق إرفاق ملاحظات بالتنبيه استنادًا إلى نتائجه.

استخدام Alert Center API

قبل استخدام Alert Center API، عليك إعداد مشروع جديد على Cloud Platform وتفعيل Alert Center API. يجب أن يستخدم مشروعك حساب خدمة عند الوصول إلى واجهة برمجة التطبيقات.

بعد أن يصبح لتطبيقك مشروع على Google Cloud يستوفي المتطلبات الأساسية وتم تفويض استخدامه بشكل صحيح، يمكنه إرسال طلبات REST إلى Alert Center API. يصبح تقديم طلبات إلى واجهة برمجة التطبيقات أسهل عند استخدام مكتبات البرامج المتاحة.

يوضّح المثال التالي كيفية عرض قائمة بالتنبيهات المتاحة باستخدام واجهة برمجة التطبيقات:

// First, authorize the API and create a client to make requests with.
URL serviceAccountUrl = AuthUtils.class.getResource("/client_secret.json");
GoogleCredentials credentials =  ServiceAccountCredentials
    .fromStream(serviceAccountUrl.openStream())
    .createDelegated("admin@xxxx.com")
    .createScoped(Collections.singleton("https://www.googleapis.com/auth/apps.alerts"));
ApacheHttpTransport transport = new ApacheHttpTransport();
HttpCredentialsAdapter adapter = new HttpCredentialsAdapter(credentials);
AlertCenter alertCenter = new AlertCenter.Builder(transport, new JacksonFactory(), adapter)
    .setApplicationName("Alert Center client")
    .build();

// List alerts in pages, printing each alert discovered.
String pageToken = null;
do {
  ListAlertsResponse listResponse = service.alerts().list().setPageToken(pageToken)
      .setPageSize(20).execute();
  if (listResponse.getAlerts() != null) {
    for (Alert alert : listResponse.getAlerts()) {
      System.out.println(alert);
    }
  }
  pageToken = listResponse.getNextPageToken();
} while (pageToken != null);