Der Bericht zu Anmeldeaktivitäten enthält Informationen zu den Anmeldeaktivitäten aller Nutzer Ihres Kontos. 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 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
Wenn Sie alle Anmeldungen für alle Dienste 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 in der API-Referenz.
Zur besseren Lesbarkeit enthält das folgende Beispiel Zeilenumbrüche:
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 in den letzten 180 Tagen abgerufen. Der Abfrageparameter maxResults sorgt dafür, dass in diesem Bericht 25 Ergebnisse pro Seite zurückgegeben werden.
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. Mit dem customerId wird angegeben, 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 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 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