نظرة عامة

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

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

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

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

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

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

بعد أن يتضمّن تطبيقك مشروعًا على السحابة الإلكترونية يستوفي المتطلبات الأساسية ويصبح مفوَّضًا بشكل صحيح، يمكنه إجراء طلبات 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);