Der Bericht zu Anmeldeaktivitäten enthält Informationen zu den Anmeldeaktivitäten aller Nutzer Ihres Kontos. Für jeden Bericht wird die grundlegende Anfrage für den Berichtsendpunkt mit berichtsspezifischen Parametern wie der E-Mail-Adresse eines Nutzers verwendet. Der maximale Zeitraum für jeden Bericht beträgt 180 Tage.
Der Bericht zu Anmeldeaktivitäten darf gemäß Ihrer Kundenvereinbarung nur für rechtmäßige Zwecke 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 Anfrage-Suchstrings und Antworteigenschaften finden Sie in der API-Referenz.
Das folgende Beispiel enthält zur besseren Lesbarkeit 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. Mit dem 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 mit allen Anmeldeereignissen eines Kunden in den letzten 180 Tagen abgerufen. Mit 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 Ereignisnamen 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
Im folgenden Beispiel wird gezeigt, wie alle verdächtig 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