Com a API Alert Center, é possível gerenciar alertas que afetam seu domínio. Um alerta é sobre um possível problema de segurança detectado pelo Google. Os alertas incluem as seguintes informações:
- Origem do alerta.
- Nome do alerta.
- Hora em que este alerta aconteceu.
- Dados específicos associados a este alerta.
Os administradores do domínio podem ver e gerenciar os alertas manualmente no Google Admin Console. A A API Alert Center permite que os apps criados por você extraiam dados e feedback de alertas. A A API também pode criar feedback para alertas existentes.
Por exemplo, um app de monitoramento pode usar a API Alert Center para recuperar as alertas mais recentes de um domínio, priorize-os e notifique os membros da sua organização. Depois que sua 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.
Quando seu app tiver um projeto do Cloud que atenda aos pré-requisitos e seja devidamente autorizado, pode fazer solicitações REST da API Alert Center. Fazer solicitações de API é mais fácil com o bibliotecas de cliente disponíveis.
O exemplo abaixo 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);