نظرة عامة

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

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

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

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

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

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

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

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

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