總覽

您可以使用 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 專案後,即可發出 Alert Center API REST 要求。使用可用的用戶端程式庫,就能更輕鬆地提出 API 要求。

以下範例說明如何使用 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);