Der Bericht zur Anmeldeaktivität gibt Informationen zu den Anmeldeaktivitäten aller Nutzer Ihres Kontos zurück. In jedem Bericht wird die einfache Endpunktanfrage für Berichte 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 Anmeldeaktivität darf nur in Übereinstimmung mit Ihrer Kundenvereinbarung für rechtmäßige Zwecke verwendet werden.
Google Workspace-Anmeldeereignisse für eine Domain abrufen
Verwenden Sie die folgende HTTP-Anfrage GET und fügen Sie das in der Dokumentation zur Autorisierung beschriebene Autorisierungstoken ein, um alle Anmeldungen für alle Domaindienste abzurufen.
Weitere Informationen zu Anfrageabfragestrings und Antwortattributen finden Sie in der API-Referenz.
Das folgende Beispiel ist zur besseren Lesbarkeit mit Zeilenumbrüchen formatiert:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?endTime=end date&startTime=start date &maxResults=maximum number of events returned on a response page
Im folgenden Beispiel werden alle Anmeldeereignisse Ihres Kontos in den letzten 180 Tagen erfasst. Der Abfrageparameter maxResults gibt an, dass dieser Bericht 25 Ergebnisse pro Seite zurückgibt.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
Im folgenden Beispiel wird ein Bericht zu allen Anmeldeereignissen eines Kunden für die letzten 180 Tage abgerufen. customerId gibt an, für welchen Kunden der Bericht abgerufen werden soll.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
Google Workspace-Anmeldungen nach Ereignisname abrufen
In einigen Fällen möchten Sie möglicherweise bestimmte Ereignisse abrufen, z. B. verdächtige erfolgreiche Anmeldungen. Verwenden Sie dazu eine GET-HTTP-Anfrage im folgenden Format:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?maxResults=maximum number of events returned on a response page &eventName=name of the login event &filters=event parameter relational operator parameter value
Das folgende Beispiel zeigt, wie Sie alle verdächtigen erfolgreichen Anmeldungen für eine Domain abrufen:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25