Reports API: Aktivitätsbericht zu Geräteprüfungen

Der Bericht zu den Prüfaktivitäten für das Gerät gibt Informationen zu den Aktivitäten aller Geräte unter Google-Endpunktverwaltung: Jeder Bericht verwendet die einfache Berichtsendpunkt-Anfrage mit berichtsspezifischen z. B. die E-Mail-Adresse des Nutzers. Der maximale Zeitraum für einen Bericht beträgt den letzten 180 Tagen.

Der Bericht zu den Prüfaktivitäten für das Gerät darf nur für rechtmäßige Zwecke in gemäß Ihrer Kundenvereinbarung erfolgen. Weitere Informationen finden Sie unter Google Workspace-Versionen vergleichen um herauszufinden, welche Versionen diese Berichte enthalten.

Geräte-Audit-Ereignisse für eine Domain abrufen

Um alle Geräte-Auditereignisse für alle Nutzer in Ihrer Domain abzurufen, verwenden Sie die GET-HTTP-Anfrage hinzugefügt und das in den Dokumentation zur Autorisierung. Weitere Informationen zu Abfragestrings und Antworteigenschaften Siehe Aktivitätsereignisse im Geräte-Audit. 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 in Ihrem Konto abgerufen für die letzten 180 Tage. Der maxResults-Abfrageparameter gibt 25 Ergebnisse pro Seite.

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

Im folgenden Beispiel wird ein Bericht über alle Geräte-Audit-Ereignisse der letzten 180 Geräte abgerufen Tage. Mit customerId wird angegeben, welcher Bericht des Kunden abgerufen wird.

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

Geräte-Audit-Ereignisse nach Ereignisname abrufen

In einigen Fällen möchten Sie vielleicht bestimmte Ereignisse, wie verdächtige Aktivitäten. Verwenden Sie dazu eine GET-HTTP-Anfrage in folgendes 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 Sie alle verdächtigen Aktivitätsereignisse für Android-Nutzer innerhalb der Domain:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25