Der Bericht zu Autorisierungstoken-Aktivitäten enthält Informationen zu Websites und Anwendungen von Drittanbietern, für die Ihre Nutzer Zugriff gewährt haben. Für jeden Bericht wird die grundlegende Anfrage für den Berichtsendpunkt mit berichtsspezifischen Parametern wie der Domain des Drittanbieters oder den gewährten Autorisierungsbereichen verwendet. Der maximale Zeitraum für jeden Bericht beträgt 180 Tage.
Der Bericht zu OAuth-Token-Aktivitäten darf gemäß Ihrer Kundenvereinbarung nur für rechtmäßige Zwecke 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 Anfrage-Suchstrings und Antworteigenschaften finden Sie in der API-Referenz.
Das folgende Beispiel enthält zur besseren Lesbarkeit 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 für die letzten 180 Tage abgerufen. Mit dem 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
Autorisierungstoken-Ereignisse nach Ereignisnamen 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