您可以使用 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);