概览

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

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

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

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

使用 Alert Center API

在使用 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("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);