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 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şkilendirilen belirli veriler.

Alan yöneticileri, uyarıları Google Yönetici konsolundan manuel olarak görebilir ve 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'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, bulgularına göre uyarıya geri bildirim ekleyebilir.

Uyarı Merkezi API'sini kullanma

Uyarı Merkezi API'yi kullanmadan önce yeni bir Cloud Platform projesi oluşturmanız ve Alerts Center API'yi 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 yetkilendirildikten sonra Alerts Center API REST istekleri yapabilir. Mevcut istemci kitaplıklarını kullanarak API isteklerinde bulunmak daha kolaydır.

Aşağıdaki örnekte, API kullanılarak kullanılabilir 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);