Der Geräteprüfungsbericht enthält Informationen zu Aktivitäten auf allen Geräten, die unter Google-Endpunktverwaltung verwaltet werden. Für jeden Bericht wird die grundlegende Endpunktanfrage für Berichte mit berichtsbezogenen Parametern wie der E-Mail-Adresse eines Nutzers verwendet. Der maximale Zeitraum für jeden Bericht beträgt 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 finden Sie Informationen dazu, in welchen Versionen diese Berichte enthalten sind.
Geräte-Audit-Ereignisse für eine Domain abrufen
Wenn Sie alle Geräte-Auditereignisse 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 den Abfragestrings für Anfragen und den Antwortattributen finden Sie unter Device Audit Activity Events.
Zur besseren Lesbarkeit enthält das folgende Beispiel 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äte-Auditereignissen 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äte-Auditereignissen 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äte-Auditereignisse nach Ereignisname abrufen
In einigen Fällen möchten Sie möglicherweise bestimmte Ereignisse abrufen, z. B. Ereignisse zu 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 Sie alle Ereignisse zu verdächtigen Aktivitäten für Android-Nutzer in der Domain abrufen:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25