Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Alert Center API cho phép bạn quản lý cảnh báo ảnh hưởng đến miền của bạn.
Cảnh báo là thông tin cảnh báo về một vấn đề bảo mật tiềm ẩn mà Google đã phát hiện.
Cảnh báo bao gồm những thông tin sau:
Nguồn tạo ra cảnh báo.
Tên của cảnh báo.
Thời gian xảy ra cảnh báo này.
Dữ liệu cụ thể liên quan đến cảnh báo này.
Quản trị viên miền có thể xem và quản lý cảnh báo theo cách thủ công trên Bảng điều khiển dành cho quản trị viên của Google. Alert Center API cho phép các ứng dụng mà bạn tạo truy xuất dữ liệu thông báo và ý kiến phản hồi về thông báo. API này cũng có thể tạo phản hồi cảnh báo mới cho các cảnh báo hiện có.
Ví dụ: một ứng dụng giám sát có thể dùng Alert Center API để truy xuất các cảnh báo gần đây nhất cho một miền, sắp xếp thứ tự ưu tiên cho các cảnh báo đó, rồi thông báo cho các thành viên trong tổ chức của bạn. Sau khi nhóm của bạn phản hồi cảnh báo, ứng dụng có thể đính kèm ý kiến phản hồi vào cảnh báo dựa trên những phát hiện của họ.
Sau khi ứng dụng của bạn có một dự án trên Cloud đáp ứng các điều kiện tiên quyết và được uỷ quyền đúng cách, ứng dụng đó có thể đưa ra các yêu cầu REST của Alert Center API. Việc đưa ra yêu cầu API sẽ dễ dàng hơn khi bạn sử dụng thư viện ứng dụng hiện có.
Ví dụ sau đây minh hoạ cách liệt kê các cảnh báo có sẵn bằng API:
Java
// First, authorize the API and create a client to make requests with.URLserviceAccountUrl=AuthUtils.class.getResource("/client_secret.json");GoogleCredentialscredentials=ServiceAccountCredentials.fromStream(serviceAccountUrl.openStream()).createDelegated("admin@xxxx.com").createScoped(Collections.singleton("https://www.googleapis.com/auth/apps.alerts"));ApacheHttpTransporttransport=newApacheHttpTransport();HttpCredentialsAdapteradapter=newHttpCredentialsAdapter(credentials);AlertCenteralertCenter=newAlertCenter.Builder(transport,newJacksonFactory(),adapter).setApplicationName("Alert Center client").build();// List alerts in pages, printing each alert discovered.StringpageToken=null;do{ListAlertsResponselistResponse=service.alerts().list().setPageToken(pageToken).setPageSize(20).execute();if(listResponse.getAlerts()!=null){for(Alertalert:listResponse.getAlerts()){System.out.println(alert);}}pageToken=listResponse.getNextPageToken();}while(pageToken!=null);
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[],[],null,["# Overview\n\nThe Alert Center API lets you manage *alerts* affecting your domain.\nAn alert is a warning of a potential security issue that Google has detected.\nAlerts include the following information:\n\n- Source that the alert originated from.\n- Name of the alert.\n- Time this alert happened.\n- Specific data associated with this alert.\n\nDomain administrators can see and manage alerts manually from the\n[Google Admin console](https://support.google.com/a/topic/2413312). The\nAlert Center API lets apps you build retrieve alert data and alert feedback. The\nAPI can also create new alert feedback for existing alerts.\n\nFor example, a monitoring app could use the Alert Center API to retrieve the\nmost recent alerts for a domain, prioritize them, and then notify members\nof your organization. After your team responds to the alert, the app could then\nattach feedback to the alert based on their findings.\n\nUse Alert Center API\n--------------------\n\n| **Note:** The current version of this API (v1beta1) is available to all Google Workspace customers.\n\nBefore using the Alert Center API you need to set up\n[a new Cloud Platform project and enable Alert Center API](/workspace/admin/alertcenter/guides/prerequisites).\nYour project must use a [service account](/identity/protocols/OAuth2ServiceAccount)\nwhen accessing the API.\n\nOnce your app has a Cloud project that meets the prerequisites and is properly\n[authorized](/workspace/admin/alertcenter/guides/authorizing), it can make\nAlert Center API REST requests. Making API requests is easier when using the\navailable [client libraries](/workspace/admin/alertcenter/guides/libraries).\n\nThe following example shows how to list available alerts using the API: \n\n### Java\n\n```java\n// First, authorize the API and create a client to make requests with.\nURL serviceAccountUrl = AuthUtils.class.getResource(\"/client_secret.json\");\nGoogleCredentials credentials = ServiceAccountCredentials\n .fromStream(serviceAccountUrl.openStream())\n .createDelegated(\"admin@xxxx.com\")\n .createScoped(Collections.singleton(\"https://www.googleapis.com/auth/apps.alerts\"));\nApacheHttpTransport transport = new ApacheHttpTransport();\nHttpCredentialsAdapter adapter = new HttpCredentialsAdapter(credentials);\nAlertCenter alertCenter = new AlertCenter.Builder(transport, new JacksonFactory(), adapter)\n .setApplicationName(\"Alert Center client\")\n .build();\n\n// List alerts in pages, printing each alert discovered.\nString pageToken = null;\ndo {\n ListAlertsResponse listResponse = service.alerts().list().setPageToken(pageToken)\n .setPageSize(20).execute();\n if (listResponse.getAlerts() != null) {\n for (Alert alert : listResponse.getAlerts()) {\n System.out.println(alert);\n }\n }\n pageToken = listResponse.getNextPageToken();\n} while (pageToken != null);\n \n```"]]
