總覽

您可以使用 Alert Center API 管理影響網域的快訊。 警示是 Google 偵測到的潛在安全性問題警告。 快訊包含下列資訊：

• 快訊的來源。
• 快訊名稱。
• 發生這則快訊的時間。
• 與這則快訊相關的特定資料。

網域管理員可以在 Google 管理控制台中查看並手動管理快訊，Alert Center API 可讓您建構的應用程式擷取快訊資料和快訊意見回饋。這個 API 也可以針對現有快訊建立新的快訊意見回饋。

舉例來說，監控應用程式可以使用 Alert Center API 來擷取網域的最新快訊、確認快訊的優先順序，然後通知機構成員。當您的團隊回應快訊後，應用程式就能根據回應結果在快訊中附上意見回饋。

使用 Alert Center API

注意： 所有 Google Workspace 客戶都能使用這個 API 的目前版本 (v1beta1)。

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