Der Bericht zur Autorisierungstoken-Aktivität gibt Informationen zu Websites und Anwendungen von Drittanbietern zurück, denen Ihre Nutzer Zugriff gewährt haben. In jedem Bericht wird die einfache Endpunktanfrage für Berichte mit berichtsspezifischen Parametern wie der Domain des Drittanbieters oder den erteilten Autorisierungsbereichen verwendet. Die maximale Zeitspanne für jeden Bericht beträgt die letzten 180 Tage.
Der Bericht zu den Aktivitäten des OAuth-Tokens darf gemäß Ihrer Kundenvereinbarung nur für rechtmäßige Zwecke verwendet werden.
Alle Autorisierungstokenereignisse 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 Autorisierungsereignisse für Drittanbieteranwendungen 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/token?endTime=end date&startTime=start date &maxResults=maximum number of events returned on a response page
Im folgenden Beispiel werden alle Autorisierungsereignisse 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/token?maxResults=25
Ereignisse des Autorisierungstokens nach Ereignisname abrufen
In einigen Fällen möchten Sie bestimmte Ereignisse abrufen, z. B. ob der Zugriff einer Anwendung widerrufen wurde. Verwenden Sie dazu eine GET-HTTP-Anfrage im folgenden Format:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/token?maxResults=maximum number of events returned on a response page &eventName=name of the OAuth token event
Das folgende Beispiel zeigt, wie alle revoke-Ereignisse für eine Domain abgerufen werden:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25