Der Bericht zur Anmeldeaktivität enthält Informationen zu den Anmeldeaktivitäten aller Nutzer Ihres Kontos. 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 umfasst die letzten 180 Tage.
Der Bericht zu Anmeldeaktivitäten darf nur für rechtmäßige Zwecke gemäß Ihrer Kundenvereinbarung verwendet werden.
Google Workspace-Anmeldeereignisse 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 Anmeldungen für alle Dienste Ihrer Domain abzurufen.
Weitere Informationen zu den Anfragestrings und Antwortattributen finden Sie in der API-Referenz.
Zur besseren Lesbarkeit ist das folgende Beispiel 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 wird ein Bericht zu allen Anmeldeereignissen Ihres Kontos der letzten 180 Tage abgerufen. Durch den Abfrageparameter maxResults werden in diesem Bericht 25 Ergebnisse pro Seite zurückgegeben.
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 in den letzten 180 Tagen 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-Anmeldeereignisse nach Ereignisname abrufen
In manchen 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 alle verdächtigen erfolgreichen Anmeldungen für eine Domain abgerufen werden:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25