Le rapport sur l'activité d'audit des appareils fournit des informations sur les activités de tous les appareils sous Gestion des points de terminaison Google. Chaque rapport utilise le point de terminaison de requête de rapport de base avec des paramètres spécifiques au rapport, tels que l'adresse e-mail d'un utilisateur. La période maximale pour chaque rapport est de 180 jours.
Le rapport sur l'activité d'audit des appareils ne peut être utilisé qu'à des fins légales, conformément à votre contrat client. Consultez Comparer les éditions Google Workspace pour savoir quelles éditions 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 la requête HTTP GET suivante et incluez le jeton d'autorisation décrit dans la documentation sur l'autorisation.
Pour en savoir plus sur les chaînes de requête et les propriétés de réponse, consultez Événements d'activité d'audit des appareils.
Pour plus 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
L'exemple suivant permet d'obtenir un rapport sur tous les événements d'audit des appareils de votre compte pour les 180 derniers jours. Le paramètre de requête maxResults renvoie 25 résultats par page.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25
L'exemple suivant récupère un rapport sur tous les événements d'audit des appareils pour les 180 derniers jours. customerId indique le rapport client à récupérer.
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 des événements spécifiques, tels que des événements d'activité suspecte. Pour ce faire, utilisez une requête HTTP GET 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 les 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