Interfejs Reports API: raport na temat aktywności kontroli urządzeń

Raport kontrolny urządzenia podaje informacje o działaniach podejmowanych przez urządzeń w Funkcje zarządzania punktami końcowymi Google Każdy raport używa podstawowego żądania punktu końcowego raportu powiązanego z konkretnym raportem takich jak adres e-mail użytkownika. Maksymalny przedział czasowy każdego raportu to ostatnich 180 dni.

Raportu z działań kontroli urządzenia można wykorzystywać wyłącznie do celów zgodnych z prawem: zgodnie z Umową klienta. Zobacz Porównanie wersji Google Workspace i sprawdź, które wersje zawierają te raporty.

Pobieranie zdarzeń kontroli urządzeń w domenie

Aby pobrać wszystkie zdarzenia kontroli urządzeń dotyczące wszystkich użytkowników w domenie, użyj po żądaniu HTTP GET i podaj token autoryzacji opisany w dokumentację autoryzacji. Aby uzyskać więcej informacji o ciągach zapytań i właściwościach odpowiedzi, zobacz Zdarzenia związane z kontrolą urządzeń. Aby zapewnić czytelność, poniższy przykład został sformatowany przy użyciu znaków zwracania 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

Ten przykład pozwala uzyskać raport o wszystkich zdarzeniach na Twoim koncie objętych kontrolą urządzeń 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

Ten przykład pozwala uzyskać raport o wszystkich zdarzeniach inspekcji urządzeń z ostatnich 180 dni. Pole customerId określa, dla którego klienta ma być 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, takich jak podejrzane zdarzenia. Aby to zrobić, użyj żądania HTTP GET na stronie następujący formularz:

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

Poniższy przykład pokazuje, jak pobrać wszystkie podejrzane zdarzenia związane z aktywnością w: Użytkownicy 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