نظرة عامة

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

استخدام Alert Center API

قبل استخدام Alert Center API، عليك إعداد مشروع جديد في Cloud Platform وتفعيل واجهة Alert 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);