Der Bericht zur Aktivität des Autorisierungstokens enthält Informationen zu Websites und Anwendungen von Drittanbietern, denen Ihre Nutzer Zugriff gewährt haben. Jeder Bericht verwendet die einfache Berichtsendpunkt-Anfrage mit berichtsspezifischen Parametern wie der Drittanbieterdomain oder den gewährten Autorisierungsbereichen. Der maximale Zeitraum für jeden Bericht umfasst die letzten 180 Tage.
Der Bericht zu den OAuth-Token-Aktivitäten darf nur für rechtmäßige Zwecke gemäß Ihrer Kundenvereinbarung verwendet werden.
Alle Autorisierungstoken-Ereignisse für eine Domain abrufen
Wenn Sie alle Autorisierungsereignisse für Anwendungen von Drittanbietern 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 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/token?endTime=end date&startTime=start date &maxResults=maximum number of events returned on a response page
Im folgenden Beispiel wird ein Bericht zu allen Autorisierungsereignissen Ihres Kontos in den letzten 180 Tagen 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/token?maxResults=25
Ereignisse vom Autorisierungstoken nach Ereignisname abrufen
In manchen Fällen möchten Sie möglicherweise 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