Der Bericht zu den Aktivitäten der Geräteprüfung enthält Informationen zu Aktivitäten aller Geräte unter der Google-Endpunktverwaltung. Für jeden Bericht wird die grundlegende Berichtsendpunkt-Anfrage mit berichtsspezifischen Parametern wie der E-Mail-Adresse eines Nutzers verwendet. Der maximale Zeitraum für jeden Bericht beträgt die letzten 180 Tage.
Der Bericht zur Geräteprüfaktivität darf nur für rechtmäßige Zwecke gemäß Ihrer Kundenvereinbarung verwendet werden. Unter Google Workspace-Versionen vergleichen können Sie nachlesen, für welche Versionen diese Berichte verfügbar sind.
Geräteprüfereignisse für eine Domain abrufen
Verwenden Sie die folgende GET-HTTP-Anfrage und fügen Sie das in der Autorisierungsdokumentation beschriebene Autorisierungstoken ein, um alle Geräteprüfereignisse für alle Nutzer in Ihrer Domain abzurufen.
Weitere Informationen zu den Anfragestrings und Antwortattributen finden Sie unter Geräte-Audit-Aktivitätsereignisse.
Zur besseren Lesbarkeit ist das folgende Beispiel mit Zeilenumbrüchen formatiert:
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
Im folgenden Beispiel wird ein Bericht zu allen Geräteprüfereignissen Ihres Kontos der letzten 180 Tage abgerufen. Der Abfrageparameter maxResults gibt 25 Ergebnisse pro Seite zurück.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25
Im folgenden Beispiel wird ein Bericht zu allen Geräteprüfungsereignissen der letzten 180 Tage abgerufen. customerId gibt an, welcher Kundenbericht abgerufen wird.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb
Geräteprüfungsereignisse nach Ereignisname abrufen
In einigen Fällen möchten Sie möglicherweise bestimmte Ereignisse wie verdächtige Aktivitätsereignisse abrufen. Verwenden Sie dazu eine GET-HTTP-Anfrage im folgenden Format:
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
Das folgende Beispiel zeigt, wie alle verdächtigen Aktivitätsereignisse für Android-Nutzer innerhalb der Domain abgerufen werden:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25