Visão geral

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A API Alert Center permite gerenciar alertas que afetam seu domínio. Um alerta é um alerta sobre um possível problema de segurança que o Google detectou. Os alertas incluem as seguintes informações:

  • A origem do alerta.
  • Nome do alerta.
  • Hora em que o alerta aconteceu.
  • Dados específicos associados a este alerta.

Os administradores de domínio podem ver e gerenciar alertas manualmente no Google Admin Console. A API Alert Center permite que os apps que você cria recuperam dados de alerta e feedbacks de alerta. A API também pode criar um novo feedback para alertas existentes.

Por exemplo, um app de monitoramento pode usar a API Alert Center para recuperar os alertas mais recentes de um domínio, priorizá-los e notificar as pessoas na sua organização. Depois que a equipe responde ao alerta, o app pode anexar feedback ao alerta com base nas descobertas.

Usar a API Alert Center

Antes de usar a API Alert Center, você precisa configurar um novo projeto do Cloud Platform e ativar a API Alert Center. O projeto precisa usar uma conta de serviço ao acessar a API.

Depois que seu app tiver um projeto do Cloud que atenda aos pré-requisitos e seja autorizado corretamente, ele poderá fazer solicitações REST da API Alert Center. É mais fácil fazer solicitações de API usando as bibliotecas de cliente disponíveis.

O exemplo a seguir mostra como listar os alertas disponíveis usando a 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);