Raport aktywności związanej z logowaniem zawiera informacje o aktywności związanej z logowaniem wszystkich użytkowników Twojego konta. Każdy raport korzysta z podstawowego żądania punktu końcowego raportu z parametrami specyficznymi dla raportu, takimi jak adres e-mail użytkownika. Maksymalny okres, jaki może obejmować każdy raport, to ostatnie 180 dni.
Raport aktywności związanej z logowaniem może być używany wyłącznie w zgodnych z prawem celach i zgodnie z Umową klienta.
Pobieranie zdarzeń logowania w Google Workspace w domenie
Aby pobrać wszystkie logowania do wszystkich usług w domenie, 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/login?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 logowania 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/login?maxResults=25
Poniższy przykład pokazuje, jak uzyskać raport o wszystkich zdarzeniach logowania klienta z ostatnich 180 dni. Znak customerId określa, dla którego klienta ma zostać pobrany raport.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
Pobieranie zdarzeń logowania w Google Workspace według nazwy zdarzenia
W niektórych przypadkach możesz chcieć pobrać konkretne zdarzenia, np. podejrzane udane logowania. Aby to zrobić, użyj żądania HTTP GET w tej postaci:
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
Poniższy przykład pokazuje, jak pobrać wszystkie podejrzane udane logowania w domenie:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25