Il report sull'attività di controllo del dispositivo restituisce informazioni sulle attività di tutti i dispositivi in Gestione degli endpoint Google. Ogni report utilizza la richiesta dell'endpoint di base del report con parametri specifici del report, ad esempio l'email di un utente. Il periodo di tempo massimo per ogni report è gli ultimi 180 giorni.
Il report sull'attività di controllo dei dispositivi può essere utilizzato solo per scopi leciti in conformità al Contratto con il cliente. Consulta Confronto tra le versioni di Google Workspace per scoprire quali versioni includono questi report.
Recuperare gli eventi di controllo dei dispositivi per un dominio
Per recuperare tutti gli eventi di controllo dei dispositivi per tutti gli utenti 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,
vedi
Eventi di attività 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 dei dispositivi del tuo account
negli 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 recupera un report su tutti gli eventi di controllo dei dispositivi degli 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 per nome evento
In alcuni casi, potresti voler recuperare eventi specifici, ad esempio eventi di attività sospetta. Per farlo, 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à sospetta 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