Tổng quan

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

  • Nguồn gốc của thông báo.
  • Tên của thông báo.
  • Thời gian thông báo này xảy ra.
  • Dữ liệu cụ thể liên quan đến thông báo này.

Quản trị viên miền có thể xem và quản lý thông báo theo cách thủ công từ 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 mà bạn tạo truy xuất dữ liệu thông báo và ý kiến phản hồi về thông báo. API này cũng có thể tạo ý kiến phản hồi mới về thông báo cho các thông báo hiện có.

Ví dụ: một ứng dụng giám sát có thể sử dụng API Trung tâm thông báo để truy xuất các thông báo gần đây nhất cho một miền, ưu tiên các thông 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 thông báo, ứng dụng có thể đính kèm ý kiến phản hồi vào thông báo dựa trên kết quả tìm thấy.

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

Trước khi sử dụng API Trung tâm thông báo, bạn cần thiết lập một dự án Google Cloud mới và bật API Trung tâm thông báo. 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 đám mây của 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ể đưa ra các yêu cầu REST của API Trung tâm thông báo. Việc đưa ra các yêu cầu API sẽ dễ dàng hơn khi bạn sử dụng các thư viện ứng dụng hiện có.

Ví dụ sau đây minh hoạ cách liệt kê các thông 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);