Omówienie interfejsu Reports API

Reports API to interfejs API typu REST, dzięki któremu możesz uzyskiwać dostęp do informacji o działaniach użytkowników w Google Workspace. Interfejs Reports API jest częścią interfejsu API pakietu Admin SDK.

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żytkownika.

Poniżej znajduje się lista terminów często używanych w interfejsie Reports API:

Raporty aktywności

Raporty o aktywności zawierają informacje dotyczące działań w konkretnej aplikacji lub usłudze Google Workspace. Raporty aktywności zawierają informacje o dacie, godzinie, użytkowniku i typie aktywności. Dokumentacja interfejsu API zawiera pełną listę raportów o aktywności wraz z informacjami, które się w nich znajdują. Oto kilka przykładowych raportów dotyczących aktywności, uporządkowanych według aplikacji lub usługi:

  • Raporty aktywności administratora zawierają informacje o czynnościach wykonanych przez administratorów przy użyciu konsoli administracyjnej. Możesz na przykład wyświetlić listę wszystkich przypadków zmiany nazwy użytkownika przez administratora za pomocą konsoli administracyjnej.
  • Raporty o 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 zobaczyć 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, a kiedy się z nich wylogowują. Możesz na przykład wygenerować raport dotyczący wszystkich logowań w Twojej domenie w określonym przedziale czasu.
  • Raporty dotyczące aktywności na urządzeniach mobilnych zawierają informacje o aktywnościach wykonywanych na urządzeniach mobilnych zarządzanych za pomocą Zarządzania urządzeniami mobilnymi w Google. Możesz na przykład otrzymywać powiadomienia, gdy użytkownicy rejestrują nowe urządzenie.
  • W raportach o aktywności tokena OAuth znajdziesz listę zdarzeń, w przypadku 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 wyświetlić listę wszystkich aplikacji innych firm, które mają dostęp do danych Google Workspace użytkownika.
Raporty o wykorzystaniu

Raporty o wykorzystaniu zawierają informacje o zdarzeniach Google Workspace w Twojej domenie. Za pomocą interfejsu API możesz prosić o określone informacje o użytkownikach.

  • Raporty o korzystaniu z usług klientów zawierają szczegółowe informacje o aktywności związanej z aplikacjami i usługami na Twoim koncie. Te informacje o wykorzystaniu są uporządkowane według typu aplikacji i zawierają dotyczące jej dane.
  • Raporty o wykorzystaniu użytkowników zawierają informacje o działaniach użytkowników konta. Raporty te można dostosowywać i filtrować pod kątem konkretnych informacji o korzystaniu. Informacje o wykorzystaniu są uporządkowane według typu aplikacji i zawierają informacje dotyczące konkretnej aplikacji.
  • Raporty o korzystaniu z elementów zawierają listę działań związanych z elementami używanymi przez użytkowników Twojego konta w aplikacji Currents.
Powiadomienia
Interfejs Reports API dostarcza powiadomienia, dzięki którym możesz obserwować zdarzenia, takie jak zmiany w zasobach. Gdy oglądasz zasób, który się zmienia, interfejs Reports API wysyła Ci powiadomienie. Więcej informacji o konfigurowaniu i otrzymywaniu powiadomień przez interfejs Reports API znajdziesz w przewodniku dotyczącym odbierania powiadomień push.

Dalsze kroki