סקירה כללית

Alert Center API מאפשר לנהל התראות שמשפיעות על הדומיין. התראה היא אזהרה לגבי בעיית אבטחה פוטנציאלית ש-Google זיהתה. ההתראות כוללות את הפרטים הבאים:

  • המקור שממנו הגיעה ההתראה.
  • שם ההתראה.
  • השעה שבה התרחשה ההתראה.
  • נתונים ספציפיים שמשויכים להתראה הזו.

מנהלי דומיינים יכולים לראות ולנהל התראות באופן ידני במסוף Google Admin. Alert Center API מאפשר לאפליקציות שיוצרים לאחזר נתוני התראות ומשוב לגבי התראות. אפשר גם ליצור באמצעות ה-API משוב חדש לגבי התראות קיימות.

לדוגמה, אפליקציית מעקב יכולה להשתמש ב-Alert Center API כדי לאחזר את ההתראות האחרונות בדומיין, לתת להן עדיפות ולשלוח הודעות לחברים בארגון. אחרי שהצוות משיב להתראה, האפליקציה יכולה לצרף משוב להתראה על סמך הממצאים שלה.

שימוש ב-Alert Center API

לפני שמשתמשים ב-Alert Center API צריך להגדיר פרויקט חדש ב-Cloud Platform ולהפעיל את Alert Center API. הפרויקט שלכם צריך להשתמש בחשבון שירות כדי לגשת ל-API.

אחרי שלאפליקציה יש פרויקט ב-Cloud שעומד בדרישות המוקדמות ומורשה בצורה תקינה, היא יכולה לשלוח בקשות REST ל-Alert Center API. קל יותר לשלוח בקשות API כשמשתמשים בספריות הלקוח הזמינות.

בדוגמה הבאה תוכלו לראות איך להציג את רשימת ההתראות הזמינות באמצעות ה-API:

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