Reports API to interfejs REST, którego możesz używać do uzyskiwania informacji o aktywności użytkowników w Google Workspace. Interfejs Reports API jest częścią Admin SDK API.
Interfejs Reports API udostępnia 2 rodzaje raportów:
- Raporty Aktywność, które zawierają zdarzenia dotyczące konkretnej aplikacji lub usługi, np. Dysku Google lub konsoli administracyjnej.
- Raporty użycia, które zawierają listę zdarzeń na koncie Workspace wywołanych przez użytkowników.
- Raporty użytkowania klienta zawierają listę zdarzeń wszystkich użytkowników w Twojej domenie.
- Raporty o użytkownikach User zawierają listę zdarzeń uporządkowanych według użytkownika.
Poniżej znajdziesz listę typowych terminów używanych w interfejsie Reports API:
- Raporty aktywności
Raporty aktywności zawierają informacje o aktywności w konkretnej aplikacji lub usłudze Google Workspace. Raporty aktywności zawierają datę, godzinę, użytkownika i rodzaj aktywności. Przewodnik po interfejsie API zawiera pełną listę raportów o aktywności i informacji, które zawierają. Oto przykładowe raporty o aktywności według aplikacji lub usługi:
- Raporty dotyczące aktywności administratorów wyświetlają działania wykonywane przez administratorów w konsoli administracyjnej. Możesz na przykład uzyskać listę wszystkich zdarzeń związanych ze zmianą imienia i nazwiska użytkownika przez administratorów za pomocą konsoli administracyjnej.
- Raporty aktywności na Dysku Google zawierają informacje o tym, jak użytkownicy w Twojej domenie edytują i wyświetlają dokumenty na Dysku. Możesz na przykład uzyskać listę aktywności konkretnego użytkownika na Dysku.
- Raporty aktywności związanej z logowaniem zawierają informacje o tym, kiedy użytkownicy Twojego konta logują się i wylogowują ze swoich kont. Możesz na przykład uzyskać raport wszystkich logowań w Twojej domenie w określonym przedziale czasu.
- Raporty o aktywności na urządzeniach mobilnych pokazują aktywność na urządzeniach mobilnych zarządzanych przez Zarządzanie urządzeniami mobilnymi Google. Możesz na przykład otrzymywać powiadomienia, gdy użytkownicy zarejestrują nowe urządzenie.
- Raporty aktywności tokena OAuth zawierają listę zdarzeń, w których użytkownicy przyznali lub anulowali tokeny autoryzacji używane przez witryny i aplikacje innych firm. Za pomocą interfejsu Reports API możesz uzyskać listę wszystkich dostępów innych firm do danych Google Workspace użytkownika.
- Raporty o wykorzystaniu
Raporty użytkowania zawierają informacje o zdarzeniach Google Workspace w Twojej domenie. Za pomocą interfejsu API możesz prosić o konkretne informacje o użytkownikach.
- Raporty o używaniu przez klientów zawierają szczegółowe informacje o aktywności związanej z aplikacjami i usługami na Twoim koncie. Informacje o użytkowaniu są uporządkowane według typu aplikacji i zawierają informacje specyficzne dla danej aplikacji.
- Raporty o użyciu przez użytkowników zawierają informacje o aktywności użytkowników Twojego konta. Raporty te można dostosowywać i filtrować, aby uzyskać konkretne informacje o użytkowaniu. Te informacje o użytkowaniu są uporządkowane według typu aplikacji i zawierają dane dotyczące konkretnej aplikacji.
- Raporty o użyciu podmiotów zawierają listę działań związanych z podmiotami używanymi przez użytkowników konta w aplikacji Currents.
- Powiadomienia
- Interfejs Reports API udostępnia powiadomienia, które umożliwiają monitorowanie zdarzeń, takich jak zmiany w zasobach. Gdy oglądasz zasób i zostanie on zmieniony, interfejs Reports API wyśle Ci powiadomienie. Więcej informacji o konfigurowaniu i otrzymywaniu powiadomień z interfejsu Reports API znajdziesz w przewodniku Otrzymywanie powiadomień push.
Dalsze kroki
Aby dowiedzieć się więcej o interfejsie Reports API i zobaczyć, jak działa, skorzystaj z przewodnika Szybki start. Znajdziesz go na pasku nawigacyjnym po lewej stronie. Przewodniki są podzielone według języka programowania. Możesz też przejść do tej sekcji, aby przeczytać ogólne informacje o zakładaniu konta.
W sekcji Autoryzacja znajdziesz informacje o tym, jak używać tokenów dostępu OAuth 2.0 do uzyskiwania danych użytkownika z aplikacji i usług Google Workspace.
Szczegółowe informacje o konkretnym typie zasobu lub metodzie znajdziesz w dokumentacji API.
Więcej informacji znajdziesz w systemie śledzenia problemów z interfejsem Admin SDK API, na blogu Google Workspace Developers i w Centrum pomocy Google Workspace Admin.