概览

借助 Alert Center API，您可以管理影响您网域的提醒。 提醒是针对 Google 检测到的潜在安全问题的一种警告。 提醒包含以下信息：

• 发出提醒的来源。
• 提醒的名称。
• 此提醒发生的时间。
• 与此提醒关联的具体数据。

域管理员可以从以下位置手动查看和管理提醒： Google 管理控制台。通过 借助 Alert Center API，您构建的应用可以检索提醒数据和提醒反馈。通过 API 还可以为现有提醒创建新的提醒反馈。

例如，监控应用可以使用 Alert Center API 检索 针对某个域的最新提醒，确定这些提醒的优先级，然后通知成员 组织内部人员。您的团队响应提醒后，应用便可以 根据调查结果在提醒中附上反馈。

使用 Alert Center API

注意 ：此 API 的当前版本 (v1beta1) 已面向所有用户提供 Google Workspace 客户。

在使用 Alert Center API 之前，您需要 新 Cloud Platform 项目并启用 Alert Center API。 您的项目必须使用服务账号 您访问 API 时所要执行的操作。

当应用具有一个满足前提条件且可以正常使用的 Cloud 项目后， authorized，可使 Alert Center API REST 请求。使用 可用的客户端库。

以下示例展示了如何使用 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("[e-mail]")
    .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);