Ringkasan

Alert Center API memungkinkan Anda mengelola notifikasi yang memengaruhi domain Anda. Notifikasi adalah peringatan tentang potensi masalah keamanan yang telah terdeteksi oleh Google. Pemberitahuan mencakup informasi berikut:

  • Sumber asal notifikasi.
  • Nama pemberitahuan.
  • Waktu notifikasi ini terjadi.
  • Data tertentu yang terkait dengan notifikasi ini.

Administrator domain dapat melihat dan mengelola notifikasi secara manual dari konsol Google Admin. Alert Center API memungkinkan aplikasi yang Anda build mengambil data notifikasi dan masukan notifikasi. API juga dapat membuat masukan notifikasi baru untuk notifikasi yang sudah ada.

Misalnya, aplikasi pemantauan bisa menggunakan Alert Center API untuk mendapatkan notifikasi domain terbaru, memprioritaskannya, lalu memberi tahu anggota organisasi Anda. Setelah tim Anda merespons notifikasi, aplikasi dapat melampirkan masukan ke notifikasi berdasarkan temuan mereka.

Menggunakan Alert Center API

Sebelum menggunakan Alert Center API, Anda harus menyiapkan project Cloud Platform baru dan mengaktifkan Alert Center API. Project Anda harus menggunakan akun layanan saat mengakses API.

Setelah memiliki project Cloud yang memenuhi prasyarat dan diberi otorisasi dengan benar, aplikasi Anda dapat membuat permintaan REST API Alert Center API. Membuat permintaan API lebih mudah saat menggunakan library klien yang tersedia.

Contoh berikut menunjukkan cara menampilkan pemberitahuan yang tersedia menggunakan API:

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);