Reports API to interfejs API typu REST, którego można używać do uzyskiwania dostępu do informacji o działaniach użytkowników w Google Workspace. Interfejs Reports API jest częścią interfejsu Admin SDK API.
Interfejs Reports API udostępnia 2 rodzaje raportów:
- Raporty aktywności, które zawierają zdarzenia dotyczące konkretnej aplikacji lub usługi, takiej jak Dysk Google czy konsola administracyjna.
- Raporty o użytkowaniu, które zawierają listę zdarzeń obszaru roboczego wywołanego przez użytkowników.
- Raporty o korzystaniu z klientów zawierają listę zdarzeń dla wszystkich użytkowników w domenie.
- Raporty o użytkowaniu użytkownicy zawierają listę zdarzeń uporządkowanych według użytkownika.
Poniżej znajdziesz listę popularnych terminów używanych w interfejsie Reports API:
- Raporty aktywności
Raporty o aktywności zawierają informacje o działaniach w konkretnej aplikacji lub usłudze Google Workspace. Raporty o aktywności zawierają datę, godzinę, użytkownika i typ aktywności. Dokumentacja API zawiera pełną listę raportów aktywności i zawartych w nich informacji. Oto kilka przykładowych raportów aktywności uporządkowanych według aplikacji lub usługi:
- Raporty aktywności administratorów zawierają informacje o działaniach wykonywanych przez administratorów przy użyciu konsoli administracyjnej. W konsoli administracyjnej możesz na przykład sprawdzić, ile razy użytkownicy zmienili nazwę użytkownika.
- Raporty aktywności na Dysku Google zawierają informacje o tym, jak użytkownicy w domenie edytują i wyświetlają dokumenty na Dysku. Możesz na przykład wyświetlić listę aktywności określonego użytkownika na Dysku.
- Raporty aktywności związanej z logowaniem zawierają informacje o tym, kiedy użytkownicy Twojego konta logują się na swoje konta i się z nich wylogują. Możesz na przykład mieć dostęp do raportów dotyczących wszystkich prób zalogowania się z domeny w danym okresie.
- Raporty aktywności na urządzeniach mobilnych zawierają aktywności korzystające z urządzeń mobilnych zarządzanych za pomocą Zarządzania urządzeniami mobilnymi w Google. Możesz na przykład otrzymywać powiadomienia, gdy użytkownicy zarejestrują nowe urządzenia.
- Raporty aktywności tokenów OAuth zawierają listę zdarzeń, w których użytkownicy przyznali lub unieważnili tokeny autoryzacji używane przez witryny i aplikacje innych firm. Za pomocą interfejsu Reports API możesz uzyskać listę wszystkich dostępu innych firm do danych Google Workspace użytkownika.
- Raporty użytkowania
Raporty o wykorzystaniu zawierają informacje o zdarzeniach Google Workspace w Twojej domenie. Interfejs API pozwala uzyskać określone informacje na temat użytkowników.
- Raporty o wykorzystaniu klienta zawierają szczegółowe informacje o aktywności na koncie i w aplikacjach. Informacje o wykorzystaniu są uporządkowane według typu aplikacji i zawierają konkretne informacje.
- Raporty użytkowania pokazują aktywność użytkowników Twojego konta. Raporty te można dostosowywać i filtrować pod kątem konkretnych informacji o wykorzystaniu. Informacje te są uporządkowane według typu aplikacji i zawierają konkretne informacje.
- Raporty użytkowania elementu zawierają listę działań związanych z podmiotami używanymi przez użytkowników Twojego konta w aplikacji Currents.
- Powiadomienia
- Interfejs Reports API umożliwia otrzymywanie powiadomień o zdarzeniach, takich jak zmiany w zasobach. Gdy oglądasz zasób i zmieniasz go, interfejs Reports API wysyła powiadomienie. Więcej informacji o konfigurowaniu i otrzymywaniu powiadomień z interfejsu Reports API znajdziesz w przewodniku Otrzymywanie powiadomień push.
Dalsze kroki
Aby dowiedzieć się, jak działa interfejs Reports API i zobaczyć, jak działa, skorzystaj z samouczka wprowadzającego, który jest wyświetlany według języka programowania na pasku nawigacyjnym po lewej stronie. W tej sekcji możesz też przeczytać ogólne informacje o konfigurowaniu konta.
Aby korzystać z interfejsu Reports API, wykonaj wymagania wstępne. Aby skonfigurować konto i zostać administratorem, Utworzysz też projekt i zarejestrujesz go w konsoli interfejsu Google API. Włączysz też usługę Reports API.
W sekcji autoryzacja pokazujemy, jak używać tokenów dostępu OAuth 2.0 do pobierania danych użytkowników z aplikacji i usług Google Workspace.
Szczegóły określonego typu zasobu lub metody znajdziesz w dokumentacji API.
Więcej informacji znajdziesz w narzędziu do śledzenia błędów interfejsu Admin SDK API, na blogu dla deweloperów Google Workspace i w Centrum pomocy dla administratorów Google Workspace.