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

Raport o aktywności związanej z tokenem autoryzacji zwraca informacje o witrynach i aplikacjach innych firm, do których użytkownicy przyznali dostęp. Każdy raport używa podstawowego żądania punktu końcowego raportu z parametrami specyficznymi dla raportu, takimi jak domena innej firmy lub przyznane zakresy autoryzacji. Maksymalny okres, z którego dane są dostępne w każdym raporcie, to ostatnie 180 dni.

Raport o aktywności związanej z tokenem OAuth może być używany tylko do celów zgodnych z Umową klienta.

Pobieranie wszystkich zdarzeń związanych z tokenem autoryzacji w domenie

Aby pobrać wszystkie zdarzenia autoryzacji dla aplikacji innych firm, użyj tego GETżądania HTTP i dołącz token autoryzacji opisany w dokumentacji autoryzacji. Więcej informacji o ciągu zapytania żądania i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu API. Aby ułatwić Ci czytanie, w tym przykładzie użyliśmy znaków łamania wiersza:

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

W tym przykładzie uzyskujesz raport ze wszystkimi zdarzeniami autoryzacji na Twoim koncie z ostatnich 180 dni. Parametr zapytania maxResults powoduje, że raport zwraca 25 wyników na stronę.

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

Pobieranie zdarzeń dotyczących tokena autoryzacji według nazwy zdarzenia

W niektórych przypadkach możesz chcieć pobrać określone zdarzenia, np. czy dostęp aplikacji został cofnięty. Aby to zrobić, wyślij żądanie 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 w domenie:

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