API Reports: rapport d'activité d'audit des appareils

Le rapport "Activité d'audit des appareils" fournit des informations sur les activités de tous appareils sous Gestion Google des points de terminaison. Chaque rapport utilise la demande de point de terminaison de base, avec des attributs paramètres tels que l'adresse e-mail de l'utilisateur. La période maximale pour chaque rapport est au cours des 180 derniers jours.

Le rapport d'activité d'audit des appareils ne peut être utilisé qu'à des fins légales dans les pays suivants : conformément à votre Contrat client. Voir Comparer les éditions Google Workspace pour identifier les éditions qui incluent ces rapports.

Récupérer les événements d'audit des appareils pour un domaine

Pour récupérer tous les événements d'audit des appareils pour tous les utilisateurs de votre domaine, utilisez le la requête HTTP GET suivante et inclure le jeton d'autorisation décrit dans la documents d'autorisation. Pour en savoir plus sur les chaînes de requête et les propriétés de réponse, voir Événements liés aux activités d'audit des appareils. Pour des raisons de lisibilité, l'exemple suivant est mis en forme avec des retours à la ligne:

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

Dans l'exemple suivant, la requête permet de générer un rapport sur tous les événements d'audit des appareils associés à votre compte. au cours des 180 derniers jours. Le paramètre de requête maxResults renvoie 25 résultats par .

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

Dans l'exemple suivant, la requête permet de générer un rapport sur tous les événements d'audit des appareils des 180 derniers jours. Le champ customerId indique quel rapport client est récupéré.

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

Récupérer les événements d'audit des appareils par nom d'événement

Dans certains cas, vous pouvez souhaiter récupérer les événements, tels que des activités suspectes. Pour ce faire, utilisez une requête HTTP GET dans au format suivant:

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'exemple suivant montre comment récupérer tous les événements d'activité suspecte pour Utilisateurs Android du domaine:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25