Raport o aktywności podczas kontroli urządzenia zwraca informacje o aktywności na wszystkich urządzeniach administrowanych za pomocą 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, jaki obejmuje każdy raport, to ostatnie 180 dni.
Raport o aktywności kontrolnej urządzenia może być używany tylko do celów zgodnych z prawem i zgodnie z Umową klienta. Aby dowiedzieć się, które wersje obejmują te raporty, zapoznaj się z artykułem Porównanie wersji Google Workspace.
Pobieranie zdarzeń z dziennika kontrolnego urządzeń w domenie
Aby pobrać wszystkie zdarzenia kontroli urządzenia dla wszystkich użytkowników w Twojej domenie, użyj tego GETżądania HTTP i dołącz token autoryzacji opisany w dokumentacji autoryzacji.
Więcej informacji o ciągu zapytania i właściwościach odpowiedzi znajdziesz w artykule Zdarzenia związane z kontrolą aktywności na urządzeniu.
Aby ułatwić Ci czytanie, w tym przykładzie użyliśmy znaków łamania wiersza:
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 uzyskujemy raport o wszystkich zdarzeniach kontroli urządzenia na Twoim 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 kontroli urządzenia z ostatnich 180 dni. Parametr customerId określa, którego klienta dotyczy pobierany raport.
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ć określone zdarzenia, np. zdarzenia związane z podejrzaną aktywnością. Aby to zrobić, użyj żądania HTTP GET w takim formacie:
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
Ten przykład pokazuje, 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