Reports API: Aktivitätsbericht zu Autorisierungs-Tokens
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[],[],null,["# Reports API: Authorization Tokens Activity Report\n\nThe authorization token activity report returns information about third party\nwebsites and applications your users have granted access for. Each report\nuses the basic report endpoint request with report-specific parameters such\nas the third party domain or authorization scopes granted. The maximum time\nperiod for each report is the last 180 days.\n\nThe OAuth token activity report may be used only for lawful purposes in accordance with your Customer Agreement.\n\nRetrieve all authorization token events for a domain\n----------------------------------------------------\n\nTo retrieve all authorization events for third party applications, use the\nfollowing `GET` HTTP request and include the authorization token described in the\n[authorization documentation](https://developers.google.com/workspace/admin/reports/v1/guides/authorizing.html).\nFor more information about the request query strings and response properties,\nsee the [API Reference](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/token-event-names).\nFor readability purposes, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/token?endTime=end date&startTime=start date\n&maxResults=maximum number of events returned on a response page\n```\n\nThe following example gets a report on all of your account's authorization events\nfor the past 180 days. The `maxResults` query parameter has this report return\n25 results per page. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25\n```\n\nRetrieve authorization token events by event name\n-------------------------------------------------\n\nIn some instances, you may want to retrieve specific events, such as whether an\napplication's access has been revoked. To do this, use a `GET` HTTP request\nof the following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/token?maxResults=maximum number of events returned on a response page\n&eventName=name of the OAuth token event\n```\n\nThe following example shows how to retrieve all `revoke` events for a domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25\n```"]]
