Interfejs Reports API to interfejs API typu RESTowy, który umożliwia dostęp do informacji o aktywności użytkowników w Google Workspace. Interfejs Reports API jest częścią interfejsu Admin SDK API.
Interfejs Reports API udostępnia 2 typy raportów:
- Raporty Aktywność zawierają informacje o zdarzeniach związanych z konkretną aplikacją lub usługą, np. Dyskiem Google czy konsolą administracyjną.
- Raporty Użycie zawierają listę zdarzeń obszaru roboczego wywołanych przez użytkowników.
- Raporty o korzystaniu z klientów zawierają listę zdarzeń dotyczących wszystkich użytkowników w domenie.
- Raporty o korzystaniu z użytkowników zawierają listę zdarzeń uporządkowanych według użytkowników.
Poniżej znajduje się lista popularnych terminów używanych w interfejsie Reports API:
- Raporty związane z aktywnością
Raporty aktywności zawierają informacje dotyczące działań w określonej aplikacji lub usłudze Google Workspace. Raporty o aktywności zawierają datę, godzinę, użytkownika i typ aktywności. Dokumentacja interfejsu API zawiera pełną listę raportów o aktywności oraz zawartych w nich informacji. Oto kilka przykładowych raportów dotyczących aktywności uporządkowanych według aplikacji lub usługi:
- Raporty o aktywności administratora zawierają informacje o czynnościach wykonywanych przez administratorów za pomocą konsoli administracyjnej. Możesz na przykład zobaczyć listę wszystkich przypadków zmiany nazwy użytkownika przez administratora przy użyciu konsoli administracyjnej.
- Raporty o aktywności na Dysku Google zawierają listę tego, jak użytkownicy w domenie edytują i wyświetlają swoje dokumenty na Dysku. Możesz na przykład zobaczyć listę aktywności konkretnego użytkownika na Dysku.
- Raporty na temat aktywności związanej z logowaniem zawierają informacje o tym, kiedy użytkownicy na Twoim koncie logują się, a kiedy wylogowują. Możesz na przykład wygenerować raport dotyczący wszystkich logowań w Twojej domenie w określonym przedziale czasu.
- Raporty o aktywności na urządzeniach mobilnych zawierają informacje o aktywnościach wykonywanych na urządzeniach mobilnych zarządzanych przez Zarządzanie urządzeniami mobilnymi w Google. Możesz na przykład otrzymywać powiadomienia, gdy użytkownicy zarejestrują nowe urządzenie.
- Raporty aktywności tokena OAuth zawierają listę zdarzeń, dla których użytkownicy przyznali lub unieważnili tokeny autoryzacji używane przez witryny i aplikacje innych firm. Dzięki interfejsowi Reports API możesz uzyskać listę wszystkich przypadków dostępu innych firm do danych Google Workspace użytkownika.
- Raporty o wykorzystaniu
Raporty o wykorzystaniu zawierają informacje o zdarzeniach Google Workspace w Twojej domenie. Interfejs API umożliwia żądanie określonych informacji o użytkownikach.
- Raporty o korzystaniu z usług klientów zawierają listę szczegółowych informacji 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ą związane z nią dane.
- Raporty o wykorzystaniu użytkowników zawierają informacje o działaniach użytkowników konta. Raporty można dostosowywać i filtrować pod kątem konkretnych informacji o korzystaniu. Informacje o użytkowaniu są uporządkowane według typu aplikacji i zawierają związane z nią dane.
- W raportach o korzystaniu z elementów są wymienione działania związane z encjami używanymi przez użytkowników konta w aplikacji Currents.
- Powiadomienia
- Interfejs Reports API wyświetla powiadomienia, dzięki którym możesz obserwować zdarzenia, takie jak zmiany w zasobach. Gdy obserwujesz zasób, który się zmienia, interfejs Reports API wysyła Ci powiadomienie. Więcej informacji o konfigurowaniu i odbieraniu powiadomień przez interfejs Reports API znajdziesz w przewodniku Otrzymywanie powiadomień push.
Dalsze kroki
Aby dowiedzieć się więcej o interfejsie Reports API i zobaczyć, jak działa, zapoznaj się z krótkim wprowadzeniem, które znajdziesz na pasku nawigacyjnym po lewej stronie według języka programowania. W tej sekcji znajdziesz też ogólne informacje o konfigurowaniu konta.
Aby używać interfejsu Reports API, wykonaj czynności wstępne, aby skonfigurować konto i zostać administratorem. Musisz też utworzyć projekt i zarejestrować go w Konsoli interfejsów API Google oraz aktywować usługę Reports API.
W sekcji autoryzacja znajdziesz informacje o tym, jak za pomocą tokenów dostępu OAuth 2.0 uzyskać dane użytkowników z aplikacji i usług Google Workspace.
Więcej informacji o określonym typie lub metodzie zasobu znajdziesz w dokumentacji interfejsu API.
Więcej informacji znajdziesz na stronie o śledzeniu problemów z interfejsem Admin SDK API, na blogu dla deweloperów Google Workspace i w Centrum pomocy dla administratorów Google Workspace.