Raport aktywności związanej z logowaniem zawiera informacje o aktywności związanej z logowaniem się na konto do użytkowników Twojego konta. Każdy raport używa podstawowego żądania punktu końcowego raportu z parametrem parametry związane z raportami, np. adres e-mail użytkownika. maksymalny okres dla każdego raportu to ostatnie 180 dni.
Raportu aktywności związanej z logowaniem się można używać tylko do celów zgodnych z prawem, zgodnie z Umową klienta.
Pobieranie zdarzeń logowania do Google Workspace dla domeny
Aby pobrać wszystkie loginy do wszystkich usług w domenie, użyj następującego polecenia:
GET i podaj token autoryzacji opisany w
dokumentację autoryzacji.
Aby uzyskać więcej informacji o ciągach zapytań i właściwościach odpowiedzi,
zobacz dokumentację API.
Aby zapewnić czytelność, poniższy przykład został sformatowany przy użyciu znaków zwracania wierszy:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?endTime=end date&startTime=start date &maxResults=maximum number of events returned on a response page
Poniższy przykład pokazuje raport o wszystkich zdarzeniach logowania się na Twoje konto dla witryny
ostatnich 180 dni. Parametr zapytania maxResults zwraca ten raport
Po 25 wyników na stronie.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
Poniższy przykład pokazuje raport o wszystkich zdarzeniach logowania się w witrynie
ostatnich 180 dni. Pole customerId określa, jakiego klienta jest raport
w celu pobrania danych.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
Pobieranie zdarzeń logowania do Google Workspace według nazwy zdarzenia
W niektórych przypadkach możesz chcieć pobrać określone
zdarzenia,
takich jak podejrzane i udane logowania. Aby to zrobić, użyj żądania HTTP GET parametru
następujący formularz:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?maxResults=maximum number of events returned on a response page &eventName=name of the login event &filters=event parameter relational operator parameter value
Przykład poniżej pokazuje, jak odzyskać wszystkie podejrzane udane logowania. dla domeny:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25