Der Bericht zu Geräteprüfungsaktivitäten enthält Informationen zu Aktivitäten aller Geräte, die über die Google-Endpunktverwaltung verwaltet werden. Für jeden Bericht wird die grundlegende Anfrage für den Berichtsendpunkt mit berichtsspezifischen Parametern wie der E-Mail-Adresse eines Nutzers verwendet. Der maximale Zeitraum für jeden Bericht beträgt 180 Tage.
Der Bericht zu Geräteprüfungsaktivitäten darf nur für rechtmäßige Zwecke gemäß Ihrer Kundenvereinbarung verwendet werden. Im Hilfeartikel Google Workspace-Versionen vergleichen erfahren Sie, welche Versionen diese Berichte enthalten.
Geräteaudit-Ereignisse für eine Domain abrufen
Wenn Sie alle Geräteauditereignisse für alle Nutzer in Ihrer Domain abrufen möchten, verwenden Sie die folgende GET HTTP-Anfrage und fügen Sie das in der Autorisierungsdokumentation beschriebene Autorisierungstoken ein.
Weitere Informationen zu Anfrage-Suchstrings und Antworteigenschaften finden Sie unter Ereignisse für die Geräteprüfung.
Das folgende Beispiel enthält zur besseren Lesbarkeit Zeilenumbrüche:
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äteauditereignissen Ihres Kontos für die 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äteauditereignissen der letzten 180 Tage abgerufen. Mit customerId wird angegeben, welcher Kundenbericht abgerufen wird.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb
Geräteauditereignisse nach Ereignisnamen abrufen
In einigen Fällen möchten Sie möglicherweise bestimmte Ereignisse abrufen, z. B. Ereignisse mit verdächtigen Aktivitäten. 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
Im folgenden Beispiel wird gezeigt, wie alle Ereignisse mit verdächtigen Aktivitäten für Android-Nutzer in 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