Panoramica

L'API Alert Center ti consente di gestire gli avvisi che interessano il tuo dominio. Un avviso è un avviso relativo a un potenziale problema di sicurezza rilevato da Google. Gli avvisi includono le seguenti informazioni:

  • Origine da cui ha avuto origine l'avviso.
  • Nome dell'avviso.
  • Ora in cui si è verificato l'avviso.
  • Dati specifici associati a questo avviso.

Gli amministratori di dominio possono visualizzare e gestire gli avvisi manualmente dalla Console di amministrazione Google. L'API Alert Center consente alle app di creare recuperare dati degli avvisi e feedback sugli avvisi. L'API può anche creare un nuovo feedback per gli avvisi esistenti.

Ad esempio, un'app di monitoraggio potrebbe utilizzare l'API Alert Center per recuperare gli avvisi più recenti per un dominio, assegnarne la priorità e poi inviare una notifica ai membri della tua organizzazione. Dopo che il team ha risposto all'avviso, l'app può allegare un feedback all'avviso in base ai risultati ottenuti.

Utilizza l'API Alert Center

Prima di utilizzare l'API Alert Center, devi configurare un nuovo progetto Cloud Platform e abilitare l'API Alert Center. Il progetto deve utilizzare un account di servizio per accedere all'API.

Una volta che l'app ha un progetto Cloud che soddisfa i prerequisiti ed è autorizzato correttamente, può effettuare richieste REST all'API Alert Center. Utilizzare le librerie client disponibili è più semplice per effettuare richieste API.

L'esempio seguente mostra come elencare gli avvisi disponibili utilizzando l'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);