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. Uyarı Merkezi API'si, uygulamaların uyarı verilerini ve uyarı geri bildirimlerini almanızı sağlar. API, mevcut uyarılar için yeni uyarı geri bildirimi de oluşturabilir.

Örneğin, bir izleme uygulaması Uyarı Merkezi API'sini kullanarak bir alanla ilgili en son uyarıları alabilir, bunlara öncelik verebilir 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şturmanız ve Uyarı Merkezi API'sini etkinleştirmeniz gerekir. Projeniz, API'ye erişirken bir hizmet hesabı kullanmalıdır.

Uygulamanız, ön koşulları karşılayan bir Cloud projesine sahip olduğunda ve uygun şekilde yetkilendirildiğinde Alerts Center API REST isteklerinde bulunabilir. 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);