Raport o 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, z którego dane są dostępne w każdym raporcie, to ostatnie 180 dni.
Raport o aktywności logowania może być używany tylko do celów zgodnych z Umową klienta.
Pobieranie zdarzeń logowania Google Workspace w domenie
Aby pobrać wszystkie dane logowania do wszystkich usług w domenie, użyj tego żądania HTTP:GET i dodaj 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/login?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 logowania 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/login?maxResults=25
W tym przykładzie uzyskujemy raport o wszystkich zdarzeniach logowania klienta z ostatnich 180 dni. Parametr 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 Google Workspace według nazwy zdarzenia
W niektórych przypadkach możesz chcieć pobrać określone zdarzenia, np. podejrzane udane logowania. Aby to zrobić, wyślij żądanie HTTP GET w tym formacie:
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
Ten 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