Genel bakış

Uyarı Merkezi API'sı, 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 oluştuğu zaman.
  • Bu uyarıyla ilişkili belirli veriler.

Alan yöneticileri, uyarıları Google Yönetici konsolundan manuel olarak görüp yönetebilir. Uyarı Merkezi API'si, oluşturduğunuz uygulamaların uyarı verilerini ve uyarı geri bildirimlerini almasını sağlar. 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

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 hizmet hesabı kullanmalıdır.

Uygulamanız, ön koşulları karşılayan ve uygun şekilde yetkilendirilen bir Cloud projesine sahip olduğunda Alert Center 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);