סקירה כללית

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