نظرة عامة

تتيح لك واجهة برمجة تطبيقات "مركز التنبيه" إدارة التنبيهات التي تؤثّر في نطاقك. التنبيه هو تحذير بشأن مشكلة أمنية مُحتمَلة رصدتها Google. تشمل التنبيهات المعلومات التالية:

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

يمكن لمشرفي النطاقات الاطّلاع على التنبيهات وإدارتها يدويًا من وحدة تحكّم المشرف في Google. تتيح واجهة برمجة تطبيقات مركز التنبيه للتطبيقات التي تُنشئها استرداد بيانات التنبيه وملاحظات التنبيه. يمكن لواجهة برمجة التطبيقات أيضًا إنشاء تعليقات تنبيه جديدة للتنبيهات الحالية.

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

استخدام واجهة برمجة تطبيقات "مركز التنبيه"

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

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

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

// 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);