Reports API: Aktivitätsbericht zu Autorisierungs-Tokens

Der Bericht zu Autorisierungstokens gibt Informationen über Drittanbieter und Websites und Anwendungen, denen Ihre Nutzer Zugriff gewährt haben. Jeder Bericht verwendet die einfache Berichtsendpunkt-Anfrage mit berichtsspezifischen Parametern wie Drittanbieterdomain oder Autorisierungsbereiche aus. Die maximale Dauer für jeden Bericht die letzten 180 Tage.

Der Bericht zur OAuth-Tokenaktivität darf nur für rechtmäßige Zwecke gemäß Ihrer Kundenvereinbarung verwendet werden.

Alle Autorisierungstoken-Ereignisse für eine Domain abrufen

Um alle Autorisierungsereignisse für Anwendungen von Drittanbietern abzurufen, verwenden Sie den GET-HTTP-Anfrage hinzugefügt und das in den 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/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 abgerufen für die 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/token?maxResults=25

Autorisierungstoken-Ereignisse nach Ereignisname abrufen

In einigen Fällen möchten Sie vielleicht bestimmte Ereignisse abrufen, z. B. ob ein der Zugriff der Anwendung wurde widerrufen. Verwenden Sie dazu eine GET-HTTP-Anfrage der folgenden Form:

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