Ringkasan

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

  • Sumber tempat notifikasi berasal.
  • Nama notifikasi.
  • Waktu notifikasi ini terjadi.
  • Data tertentu yang terkait dengan notifikasi ini.

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

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

Gunakan 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 diotorisasi dengan benar, aplikasi tersebut dapat membuat permintaan REST API Pusat Notifikasi. Pembuatan permintaan API akan lebih mudah jika 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);