Genel bakış

Uyarı Merkezi API, alanınızı etkileyen uyarıları yönetmenize olanak tanır. Uyarı, Google'ın tespit ettiği olası bir güvenlik sorunu için verilen 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şkilendirilen belirli veriler.

Alan yöneticileri, uyarıları Google Yönetici konsolundan manuel olarak görüntüleyip yönetebilir. Uyarı Merkezi API'si, derlediğiniz 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, 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.

Uyarı Merkezi API'sini kullanma

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

Uygulamanız ön koşulları karşılayan ve düzgün şekilde yetkilendirilen bir Cloud projesine sahip olduğunda Uyarı Merkezi API REST isteklerinde bulunabilir. Mevcut istemci kitaplıklarını kullanırken API istekleri yapmak daha kolaydır.

Aşağıdaki örnekte, API'yi kullanarak 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);