نظرة عامة

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

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

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

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

استخدام واجهة Alert Center API

قبل استخدام واجهة Alert Center API، عليك إعداد مشروع جديد على Google Cloud وتفعيل واجهة 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);