نظرة عامة

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

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

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

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

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

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

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

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

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