סקירה כללית

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