Il report sulle attività di accesso restituisce informazioni sulle attività di accesso di tutti gli utenti del tuo account. Ogni report utilizza la richiesta dell'endpoint del report di base con parametri specifici del report come l'email di un utente. La per ciascun report il periodo di tempo massimo è gli ultimi 180 giorni.
Il report sull'attività di accesso può essere utilizzato solo per scopi legittimi in conformità con il Contratto con il cliente.
Recuperare gli eventi di accesso a Google Workspace per un dominio
Per recuperare tutti gli accessi per tutti i servizi del tuo dominio, utilizza quanto segue
GET Richiesta HTTP e includi il token di autorizzazione descritto nell'
documentazione sull'autorizzazione.
Per ulteriori informazioni sulle stringhe di query per la richiesta e
sulle proprietà delle risposte,
consulta Riferimento API.
Per motivi di leggibilità, l'esempio seguente è formattato con i ritorni a riga:
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
L'esempio seguente genera un report su tutti gli eventi di accesso al tuo account per
gli ultimi 180 giorni. Il parametro di query maxResults restituisce questo report
25 risultati per pagina.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
L'esempio seguente genera un report su tutti gli eventi di accesso di un cliente per
gli ultimi 180 giorni. L'elemento customerId specifica a quale cliente si riferisce la segnalazione
da recuperare.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
Recuperare gli eventi di accesso a Google Workspace per nome evento
In alcuni casi, potresti voler recuperare requisiti specifici
eventi,
ad esempio accessi sospetti riusciti. A questo scopo, utilizza una richiesta HTTP GET di
il seguente modulo:
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
L'esempio seguente mostra come recuperare tutti gli accessi sospetti riusciti per un dominio:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25