Der Bericht zur Aktivität von Autorisierungstokens enthält Informationen zu Websites und Anwendungen von Drittanbietern, denen Ihre Nutzer Zugriff gewährt haben. Für jeden Bericht wird die grundlegende Endpunktanfrage für Berichte mit berichtsbezogenen Parametern wie der Drittanbieterdomain oder den gewährten Autorisierungsbereichen verwendet. Der maximale Zeitraum für jeden Bericht beträgt die letzten 180 Tage.
Der Bericht zu 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 Drittanbieteranwendungen 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/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 der letzten 180 Tage 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/token?maxResults=25
Autorisierungstoken-Ereignisse nach Ereignisname abrufen
In einigen 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
Im folgenden Beispiel wird gezeigt, 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