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 bir 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

Uyarı Merkezi API'yi kullanmadan önce yeni bir Cloud Platform projesi oluşturup Uyarı Merkezi API'yi etkinleştirmeniz gerekir. Projeniz, API'ye erişirken hizmet hesabı kullanmalıdır.

Uygulamanızın ön koşulları karşılayan ve düzgün şekilde yetkilendirilmiş bir Cloud projesi olduğunda Alert Center API REST istekleri gönderebilir. Mevcut istemci kitaplıkları kullanıldığında API istekleri 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);