Genel bakış

Alert Center API, alanınızı etkileyen uyarılar yönetmenize olanak tanır. Uyarı, Google'ın tespit ettiği olası bir güvenlik sorunuyla ilgili uyarıdır. Uyarılar aşağıdaki bilgileri içerir:

  • Uyarının kaynağı.
  • Uyarının adı.
  • Bu uyarının gerçekleştiği zaman.
  • Bu uyarıyla ilişkili belirli veriler.

Alan yöneticileri, uyarıları Google Yönetici Konsolu'ndan manuel olarak görüp yönetebilir. Alert Center API, oluşturduğunuz uygulamaların uyarı verilerini ve uyarı geri bildirimlerini almasına olanak tanır. API, mevcut uyarılar için yeni uyarı geri bildirimi de oluşturabilir.

Örneğin, bir izleme uygulaması Alert Center API'yi kullanarak bir alanla ilgili en son uyarıları alabilir, bunlar için öncelik belirleyebilir ve ardından kuruluşunuzun üyelerini bilgilendirebilir. Ekibiniz uyarıya yanıt verdikten sonra uygulama, ekibin bulgularına göre uyarıya geri bildirim ekleyebilir.

Alert Center API'yi kullanma

Alert Center API'yi kullanmadan önce yeni bir Cloud Platform projesi oluşturmanız ve Alert Center API'yi etkinleştirmeniz gerekir. Projeniz, API'ye erişirken bir hizmet hesabı kullanmalıdır.

Uygulamanızda ön koşulları karşılayan ve uygun şekilde yetkilendirilmiş bir Cloud projesi olduğunda Alert Center API REST istekleri gönderebilir. Mevcut istemci kitaplıklarını kullanarak API isteği göndermek daha kolaydır.

Aşağıdaki örnekte, API kullanılarak mevcut uyarıların nasıl listeleneceği gösterilmektedir:

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);