نظرة عامة

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

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

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

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

استخدام Alert Center API

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

بعد أن يحصل تطبيقك على مشروع على 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);