نظرة عامة

تتيح لك واجهة برمجة تطبيقات "مركز التنبيه" إدارة التنبيهات التي تؤثر على نطاقك. التنبيه هو تحذير بشأن مشكلة أمنية محتملة رصدتها 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);