סקירה כללית

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