Il report sull'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, ad esempio l'email di un utente. Il periodo di tempo massimo per ogni report è di 180 giorni.
Il report sull'attività di accesso può essere utilizzato solo per scopi leciti in conformità al 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 la seguente
richiesta HTTP GET e includi il token di autorizzazione descritto nella
documentazione sull'autorizzazione.
Per ulteriori informazioni sulle stringhe di query della richiesta e sulle proprietà della risposta,
consulta il riferimento API.
Per favorire la leggibilità, il seguente esempio è formattato con ritorni a capo:
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 recupera un report su tutti gli eventi di accesso dell'account negli ultimi 180 giorni. Il parametro della query maxResults fa in modo che questo report restituisca
25 risultati per pagina.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
L'esempio seguente recupera un report su tutti gli eventi di accesso di un cliente
negli ultimi 180 giorni. customerId specifica per quale cliente deve essere recuperato il report.
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 eventi specifici, ad esempio accessi riusciti sospetti. Per farlo, utilizza una richiesta HTTP GET del 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 riusciti sospetti 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