نظرة عامة

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

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

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

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

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

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

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

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

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