Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Interfejs Alert Center API umożliwia zarządzanie alertami dotyczącymi Twojej domeny.
Alert to ostrzeżenie o potencjalnym problemie z bezpieczeństwem, który wykryliśmy.
Alerty zawierają te informacje:
Źródło, z którego pochodzi alert.
Nazwa alertu.
Czas wystąpienia alertu.
Konkretne dane powiązane z tym alertem.
Administratorzy domen mogą ręcznie wyświetlać alerty i zarządzać nimi w konsoli administracyjnej Google. Interfejs Alert Center API umożliwia tworzonym przez Ciebie aplikacjom pobieranie danych alertów i informacji zwrotnych na ich temat. Interfejs API może też generować nowe informacje zwrotne dotyczące istniejących alertów.
Na przykład aplikacja do monitorowania może używać interfejsu Alert Center API do pobierania najnowszych alertów dotyczących domeny, nadawania im priorytetów i powiadamiania osób w organizacji. Gdy zespół odpowie na alert, aplikacja może następnie dołączyć do niego informacje zwrotne na podstawie ustaleń.
Gdy aplikacja będzie miała projekt Cloud, który spełnia wymagania wstępne i jest odpowiednio autoryzowany, będzie mogła wysyłać żądania REST do interfejsu Alert Center API. Wysyłanie żądań interfejsu API jest łatwiejsze, gdy korzystasz z dostępnych bibliotek klienta.
Przykład poniżej pokazuje, jak za pomocą interfejsu API wyświetlić listę dostępnych alertów:
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);
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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```"]]
