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

Raport aktywności tokena autoryzacji zawiera informacje o witrynach i aplikacjach innych firm, którym użytkownicy przyznali dostęp. Każdy raport korzysta z podstawowego żądania punktu końcowego raportu z parametrami związanymi z raportami, takimi jak przyznany podmiot zewnętrzny czy zakresy autoryzacji. Maksymalny okres w przypadku każdego raportu to ostatnie 180 dni.

Raportu aktywności związanej z tokenem OAuth można używać wyłącznie w celach zgodnych z prawem, zgodnie z Umową klienta.

Pobierz wszystkie zdarzenia tokena autoryzacji dla domeny

Aby pobrać wszystkie zdarzenia autoryzacji aplikacji innych firm, użyj tego żądania HTTP GET i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Więcej informacji o ciągach zapytań i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu API. Aby zwiększyć czytelność, poniższy przykład został sformatowany ze zwrotami 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 zawiera raport o wszystkich zdarzeniach autoryzacji konta z ostatnich 180 dni. Parametr zapytania maxResults powoduje, że ten raport zwraca 25 wyników na stronę.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25

Pobierz zdarzenia 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ł unieważniony. Użyj do tego żądania HTTP GET w takiej formie:

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

Z przykładu poniżej dowiesz się, jak pobrać wszystkie zdarzenia revoke z domeny:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25