Raport aktywności dotyczący kontroli urządzeń zawiera informacje o aktywności wszystkich urządzeń w ramach zarządzania punktami końcowymi Google. Każdy raport korzysta z podstawowego żądania punktu końcowego raportu z parametrami specyficznymi dla raportu, takimi jak adres e-mail użytkownika. Maksymalny okres, za który możesz wygenerować raport, to ostatnie 180 dni.
Raport aktywności kontrolnej urządzenia może być używany wyłącznie do zgodnych z prawem celów zgodnie z Umową klienta. Więcej informacji o tym, które wersje obejmują te raporty, znajdziesz w artykule Porównanie wersji Google Workspace.
Pobieranie zdarzeń kontrolnych urządzeń w domenie
Aby pobrać wszystkie zdarzenia kontroli dotyczące urządzeń wszystkich użytkowników w Twojej domenie, użyj poniższego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji.
Więcej informacji o ciągach zapytania w żądaniu i właściwościach odpowiedzi znajdziesz w artykule Zdarzenia związane z kontrolą aktywności na urządzeniu.
Aby zwiększyć czytelność, poniższy przykład zawiera znaki łamania wierszy:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/mobile?endTime=end date&startTime=start date &maxResults=maximum number of events returned on a response page
W tym przykładzie pobierany jest raport o wszystkich zdarzeniach kontroli urządzeń na koncie z ostatnich 180 dni. Parametr zapytania maxResults zwraca 25 wyników na stronę.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25
W tym przykładzie pobierany jest raport o wszystkich zdarzeniach kontrolnych dotyczących urządzeń z ostatnich 180 dni. Symbol customerId określa, raport którego klienta ma zostać pobrany.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb
Pobieranie zdarzeń kontroli urządzenia według nazwy zdarzenia
W niektórych przypadkach możesz chcieć pobrać konkretne zdarzenia, np. zdarzenia związane z podejrzaną aktywnością. Aby to zrobić, użyj żądania HTTP GET w tej formie:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/mobile?maxResults=maximum number of events returned on a response page &eventName=name of the event &filters=event parameter relational operator parameter value
W tym przykładzie pokazujemy, jak pobrać wszystkie zdarzenia podejrzanej aktywności użytkowników Androida w domenie:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25