סקירה כללית

באמצעות 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 שעונה על הדרישות המוקדמות ואושר כראוי, תוכלו לשלוח בקשות API ל-Alert Center ב-REST. קל יותר לשלוח בקשות 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);