Il report Attività di controllo del dispositivo restituisce informazioni sulle attività di tutti i dispositivi sottoposti a gestione degli endpoint Google. Ogni report utilizza la richiesta di endpoint report di base con parametri specifici del report, ad esempio l'email di un utente. Il periodo di tempo massimo per ogni report è costituito dagli ultimi 180 giorni.
Il report Attività di controllo del dispositivo può essere utilizzato solo per scopi legali in conformità con il Contratto con il cliente. Consulta Confronta le versioni di Google Workspace per scoprire quali versioni includono questi report.
Recuperare gli eventi di controllo del dispositivo per un dominio
Per recuperare tutti gli eventi di controllo del dispositivo per tutti gli utenti all'interno 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à di risposta, consulta Eventi di attività del log di controllo del dispositivo.
Per favorire la leggibilità, il seguente esempio è formattato con ritorni a capo:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/mobile?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 controllo del dispositivo del tuo account
per gli ultimi 180 giorni. Il parametro di query maxResults restituisce 25 risultati per pagina.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25
L'esempio seguente genera un report su tutti gli eventi di controllo del dispositivo negli ultimi 180 giorni. customerId specifica il report del cliente da recuperare.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb
Recuperare gli eventi di controllo del dispositivo in base al nome dell'evento
In alcuni casi, potresti voler recuperare eventi specifici, come quelli di attività sospette. A tale scopo, utilizza una richiesta HTTP GET nel
seguente formato:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/mobile?maxResults=maximum number of events returned on a response page &eventName=name of the event &filters=event parameter relational operator parameter value
L'esempio seguente mostra come recuperare tutti gli eventi di attività sospette per gli utenti Android all'interno del dominio:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25