Interfejs Reports API: raport o aktywności tokenów autoryzacji
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Raport aktywności tokena autoryzacji zawiera informacje o witrynach i aplikacjach innych firm, do których użytkownicy przyznali dostęp. Każdy raport korzysta z podstawowego punktu końcowego żądania raportu z parametrami specyficznymi dla raportu, takimi jak domena firmy zewnętrznej lub przyznane zakresy autoryzacji. Maksymalny okres, za który można wygenerować raport, to ostatnie 180 dni.
Raport aktywności tokena OAuth może być używany wyłącznie w celach zgodnych z prawem i zgodnie z Umową klienta.
Pobieranie wszystkich zdarzeń tokenów autoryzacji w domenie
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
Poniższy przykład pobiera raport o wszystkich zdarzeniach autoryzacji na Twoim koncie z ostatnich 180 dni. Parametr zapytania maxResults powoduje, że ten raport zwraca 25 wyników na stronie.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25
Pobieranie zdarzeń tokena autoryzacji według nazwy zdarzenia
W niektórych przypadkach możesz chcieć pobrać konkretne zdarzenia, np. informacje o tym, czy dostęp aplikacji został cofnięty. Aby to zrobić, użyj żądania HTTP GET w tym formacie:
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
Poniższy przykład pokazuje, jak pobrać wszystkie zdarzenia revoke dla domeny:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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```"]]
