Ringkasan

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

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

Administrator domain dapat melihat dan mengelola pemberitahuan secara manual dari Konsol Google Admin. Tujuan Alert Center API memungkinkan aplikasi yang Anda buat untuk mengambil data pemberitahuan dan masukan pemberitahuan. Tujuan API juga dapat membuat masukan pemberitahuan baru untuk pemberitahuan yang ada.

Misalnya, aplikasi pemantauan bisa menggunakan Alert Center API untuk mengambil pemberitahuan terbaru untuk domain, prioritaskan, lalu beri tahu anggota organisasi Anda. Setelah tim Anda merespons peringatan tersebut, aplikasi kemudian dapat melampirkan masukan ke pemberitahuan berdasarkan temuan mereka.

Menggunakan Alert Center API

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

Setelah aplikasi Anda memiliki project Cloud yang memenuhi prasyarat dan diotorisasi, pengguna dapat membuat Permintaan REST API Pusat Pemberitahuan. 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);