نظرة عامة

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

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

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

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

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

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

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

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

Java

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