Interfejs 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ą interfejsu Admin SDK API.
Interfejs API raportów udostępnia 2 rodzaje raportów:
- Aktywność – raporty o zdarzeniach dotyczących konkretnej aplikacji lub usługi, np. Dysku Google lub konsoli administracyjnej.
- Wykorzystanie – raporty, które zawierają listę zdarzeń w przestrzeni roboczej wywołanych przez użytkowników.
- Klienci raporty użytkowania zawierają listę zdarzeń dla wszystkich użytkowników w Twojej domenie.
- Raporty dotyczące korzystania z użytkowników zawierają listę zdarzeń uporządkowaną według użytkownika.
Oto lista typowych terminów używanych w interfejsie Reports API:
- Raporty o aktywności
Raporty aktywności zawierają informacje o działaniach w konkretnej usłudze lub aplikacji Google Workspace. Raporty o aktywności zawierają datę, godzinę, użytkownika i typ aktywności. Przewodnik po interfejsie API zawiera pełną listę raportów aktywności i zawieranych w nich informacji. Oto przykładowe raporty aktywności, uporządkowane według aplikacji lub usługi:
- Raporty o aktywności administratora zawierają informacje o czynnościach wykonywanych przez administratorów w konsoli administracyjnej. Możesz na przykład uzyskać listę wszystkich przypadków, w których administratorzy zmienili nazwę użytkownika 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 danego użytkownika na Dysku.
- Raporty o aktywności związanej z logowaniem się zawierają informacje o tym, kiedy użytkownicy Twojego konta logują się na swoje konta i z nich się wylogowują. Możesz na przykład uzyskać raport ze wszystkimi logowaniami w domenie w określonym przedziale czasu.
- Raporty o aktywności na urządzeniach mobilnych zawierają informacje o aktywności na urządzeniach mobilnych zarządzanych przez Zarządzanie urządzeniami mobilnymi w Google. Możesz na przykład otrzymywać powiadomienia, gdy użytkownicy rejestrują nowe urządzenie.
- Raporty o aktywności związanej z tokenami OAuth zawierają listę zdarzeń, w których Twoi 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 aplikacji innych firm, które mają dostęp do danych Google Workspace użytkownika.
- Raporty dotyczące wykorzystania
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 dotyczące korzystania przez klientów zawierają szczegółowe informacje o aktywnościach związanych z aplikacją i usługami na Twoim koncie. Informacje o użytkowaniu są uporządkowane według typu aplikacji i zawierają informacje dotyczące tej aplikacji.
- Raporty o użyciu przez użytkowników pokazują aktywność użytkowników Twojego konta. Te raporty możesz dostosowywać i filtrować pod kątem konkretnych informacji o użytkowaniu. Informacje o korzystaniu z aplikacji są uporządkowane według typu aplikacji i zawierają informacje dotyczące tej aplikacji.
- Raporty o używaniu 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 wysyła powiadomienia, które umożliwiają śledzenie zdarzeń, takich jak zmiany zasobów. Gdy obserwujesz zasób, który się zmienia, interfejs Reports API wysyła powiadomienie. Więcej informacji o konfigurowaniu i odbieraniu powiadomień z interfejsu Reports API znajdziesz w przewodniku Odbieranie powiadomień push.
Dalsze kroki
Aby dowiedzieć się więcej o interfejsie Reports API i sposobie jego działania, skorzystaj z krótkiego wprowadzenia, które znajdziesz na pasku nawigacyjnym po lewej stronie. Możesz też kontynuować czytanie tej sekcji, aby dowiedzieć się więcej o konfigurowaniu konta.
W sekcji autoryzacja dowiesz się, jak używać tokenów dostępu OAuth 2.0 do uzyskiwania danych użytkowników z aplikacji i usług Google Workspace.
Szczegółowe informacje o konkretnym typie zasobu lub metodzie znajdziesz w dokumentacji interfejsu API.
Więcej informacji znajdziesz w śledzeniu problemów z interfejsem Admin SDK API, blogu Google Workspace dla deweloperów oraz w Centrum pomocy Google Workspace dla administratorów.