Reports API: raport z działań kontroli urządzeń

Raport działań kontroli urządzeń zawiera informacje o działaniach wszystkich urządzeń objętych zarządzaniem punktami końcowymi Google. Każdy raport korzysta z podstawowego żądania punktu końcowego raportu z parametrami związanymi z raportem, np. adresem e-mail użytkownika. Maksymalny okres w przypadku każdego raportu to ostatnie 180 dni.

Raportu aktywności związanej z kontrolą urządzenia można używać wyłącznie do celów zgodnych z prawem zgodnie z Umową klienta. Aby dowiedzieć się, które wersje zawierają te raporty, zapoznaj się z artykułem Porównanie wersji Google Workspace.

Pobieranie zdarzeń kontroli urządzeń w domenie

Aby pobrać wszystkie zdarzenia kontroli urządzeń wszystkich użytkowników w domenie, użyj tego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Więcej informacji o ciągach zapytań i właściwościach odpowiedzi znajdziesz w artykule Zdarzenia dotyczące działań kontroli urządzeń. Aby zwiększyć czytelność, poniższy przykład został sformatowany ze zwrotami 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

Podany niżej przykład zawiera raport o wszystkich zdarzeniach kontroli urządzeń 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

Poniższy przykład zawiera raport o wszystkich zdarzeniach kontroli urządzenia z ostatnich 180 dni. customerId określa, który raport klienta jest pobierany.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

Pobierz zdarzenia kontroli urządzenia według nazwy zdarzenia

W niektórych przypadkach możesz chcieć pobrać konkretne zdarzenia, np. zdarzenia podejrzanej aktywności. 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

Z przykładu poniżej dowiesz się, 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