API Reports: rapporto Attività di controllo dispositivo

Il report sull'attività di controllo dei dispositivi restituisce informazioni sulle attività di tutti i dispositivi in Gestione degli endpoint Google. Ogni report utilizza la richiesta dell'endpoint del report di base con parametri specifici del report, come l'email di un utente. Il periodo di tempo massimo per ogni report corrisponde agli ultimi 180 giorni.

Il report sull'attività di controllo del dispositivo può essere utilizzato solo per scopi leciti, in conformità con il Contratto con il cliente. Per sapere quali versioni includono questi report, consulta il confronto tra le versioni di Google Workspace.

Recuperare gli eventi di controllo dei dispositivi per un dominio

Per recuperare tutti gli eventi di controllo dei dispositivi per tutti gli utenti del dominio, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto nella documentazione relativa all'autorizzazione. Per ulteriori informazioni sulle stringhe di query di richiesta e sulle proprietà della risposta, consulta Eventi dell'attività di controllo dei dispositivi. Per motivi di leggibilità, il seguente esempio viene formattato con ritorni a riga:

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 restituisce un report su tutti gli eventi di controllo dei dispositivi del tuo account relativi agli 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 restituisce un report su tutti gli eventi di controllo dei dispositivi degli ultimi 180 giorni. L'elemento customerId specifica il report del cliente che viene recuperato.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

Recupera gli eventi di controllo dei dispositivi in base al nome evento

In alcuni casi, potresti voler recuperare eventi specifici, ad esempio eventi di attività sospette. A questo 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