Ringkasan

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

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

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

Misalnya, aplikasi pemantauan dapat menggunakan Alert Center API untuk mengambil 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 perlu menyiapkan project Cloud Platform baru dan mengaktifkan Alert Center API. Project Anda harus menggunakan akun layanan saat mengakses API.

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

Contoh berikut menunjukkan cara membuat daftar 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);