סקירה כללית

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

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

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

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

שימוש ב-Alert Center API

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

אחרי שלאפליקציה שלכם יהיה פרויקט בענן של Google שעומד בדרישות המוקדמות ומאושר בצורה תקינה, היא תוכל לשלוח בקשות 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);