Il report sulle attività di controllo del dispositivo restituisce informazioni sulle attività di tutti sotto il Gestione degli endpoint Google. Ogni report utilizza la richiesta dell'endpoint del report di base con specifiche come l'email dell'utente. Il periodo di tempo massimo per ogni report è gli ultimi 180 giorni.
Il report sulle attività di controllo dei dispositivi può essere utilizzato solo per scopi legittimi in in conformità con il Contratto con il cliente. Consulta Confronto tra le versioni di Google Workspace per individuare le versioni che 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 all'interno del tuo dominio, utilizza il
a seguito di una richiesta HTTP GET
e includere il token di autorizzazione descritto in
documentazione sull'autorizzazione.
Per ulteriori informazioni sulle stringhe di query per la richiesta e
sulle proprietà delle risposte,
vedi
Eventi relativi alle attività di controllo dei dispositivi.
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/mobile?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 controllo dei dispositivi del tuo account
degli ultimi 180 giorni. Il parametro di query maxResults
restituisce 25 risultati per
.
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 relativi agli ultimi 180
giorni. Il parametro customerId
specifica il report del cliente che viene recuperato.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb
Recuperare gli eventi di controllo dei dispositivi in base al nome evento
In alcuni casi, potresti voler recuperare requisiti specifici
eventi,
ad esempio eventi di attività sospette. A questo scopo, utilizza una richiesta HTTP GET
il seguente modulo:
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 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