Aperçu

L'API Alert Center vous permet de gérer les alertes qui affectent votre domaine. Une alerte est un avertissement concernant un problème de sécurité potentiel détecté par Google. Les alertes incluent les informations suivantes :

  • Source de l'alerte.
  • Nom de l'alerte.
  • Heure à laquelle cette alerte s'est produite.
  • Données spécifiques associées à cette alerte.

Les administrateurs de domaine peuvent consulter et gérer manuellement les alertes depuis la console d'administration Google. L'API Alert Center permet aux applications que vous créez de récupérer des données et des commentaires d'alerte. L'API peut également créer de nouveaux commentaires pour les alertes existantes.

Par exemple, une application de surveillance peut utiliser l'API Alert Center pour récupérer les alertes les plus récentes concernant un domaine, leur accorder des priorités, puis envoyer des notifications aux membres de votre organisation. Une fois que votre équipe a répondu à l'alerte, l'application peut y joindre des commentaires en fonction de ses résultats.

Utiliser l'API Alert Center

Avant d'utiliser l'API Alert Center, vous devez configurer un projet Cloud Platform et activer l'API Alert Center. Votre projet doit utiliser un compte de service pour accéder à l'API.

Une fois que votre application dispose d'un projet Cloud qui répond aux prérequis et qui est correctement autorisé, elle peut effectuer des requêtes REST de l'API Alert Center. Il est plus facile d'effectuer des requêtes API à l'aide des bibliothèques clientes disponibles.

L'exemple suivant montre comment lister les alertes disponibles à l'aide de 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("[email protected]")
    .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);