Tổng quan

API Trung tâm thông báo cho phép bạn quản lý cảnh báo ảnh hưởng đến miền của mình. Cảnh báo là thông báo về một vấn đề bảo mật tiềm ẩn mà Google đã phát hiện. Cảnh báo bao gồm các thông tin sau:

  • Nguồn phát sinh cảnh báo.
  • Tên của cảnh báo.
  • Thời điểm xảy ra cảnh báo này.
  • Dữ liệu cụ thể liên quan đến cảnh báo này.

Quản trị viên miền có thể xem và quản lý cảnh báo theo cách thủ công trong Bảng điều khiển dành cho quản trị viên của Google. API Trung tâm thông báo cho phép các ứng dụng bạn tạo truy xuất dữ liệu thông báo và phản hồi thông báo. API cũng có thể tạo phản hồi cảnh báo mới cho các cảnh báo hiện có.

Ví dụ: một ứng dụng giám sát có thể sử dụng Alert Center API để truy xuất các cảnh báo gần đây nhất cho một miền, sắp xếp thứ tự ưu tiên cho các cảnh báo đó, sau đó thông báo cho các thành viên trong tổ chức của bạn. Sau khi nhóm của bạn phản hồi cảnh báo, ứng dụng có thể đính kèm ý kiến phản hồi vào cảnh báo dựa trên kết quả của họ.

Sử dụng API Trung tâm thông báo

Trước khi sử dụng Alert Center API, bạn cần thiết lập một dự án Cloud Platform mới và bật Alert Center API. Dự án của bạn phải sử dụng tài khoản dịch vụ khi truy cập vào API.

Sau khi ứng dụng của bạn có một dự án trên Google Cloud đáp ứng các điều kiện tiên quyết và được uỷ quyền đúng cách, ứng dụng đó có thể gửi yêu cầu REST Alert Center API. Việc tạo yêu cầu API sẽ dễ dàng hơn khi sử dụng các thư viện ứng dụng hiện có.

Ví dụ sau đây cho thấy cách liệt kê các cảnh báo hiện có bằng 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);