Interfejs Reports API: raport o aktywności tokenów autoryzacji

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

Aby pobrać wszystkie zdarzenia autoryzacji aplikacji innych firm, użyj tego żądania HTTPGET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Więcej informacji o ciągach zapytania w żądaniach i właściwościach odpowiedzi znajdziesz w dokumentacji API. Aby zwiększyć czytelność, poniższy przykład zawiera znaki łamania wierszy:

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