Reports API: Bericht zur Anmeldeaktivität

Der Bericht zur Anmeldeaktivität gibt Informationen über die Anmeldeaktivitäten aller für die Nutzer Ihres Kontos. Für jeden Bericht wird die grundlegende Anfrage für den Berichtsendpunkt mit berichtsspezifische Parameter wie die E-Mail-Adresse eines Nutzers. Die 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 folgenden Befehl, um alle Anmeldungen für alle Dienste Ihrer Domain abzurufen: GET-HTTP-Anfrage senden und das Autorisierungstoken angeben, das im Dokumentation zur Autorisierung. Weitere Informationen zu Abfragestrings und Antworteigenschaften 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 der letzten 180 Tage. Für den Abfrageparameter maxResults wurde dieser Bericht zurückgegeben 25 Ergebnisse pro Seite

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

Im folgenden Beispiel wird ein Bericht über alle Anmeldeereignisse eines Kunden für der letzten 180 Tage. Die customerId gibt an, für welchen Kunden der Bericht gilt. für die 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 vielleicht bestimmte Ereignisse, wie verdächtige Anmeldungen. Verwenden Sie dazu eine GET-HTTP-Anfrage von folgendes 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 abgerufen werden für eine Domain:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25