Le rapport d'activité d'audit des appareils renvoie des informations sur les activités de tous les appareils concernés par la gestion Google des points de terminaison. Chaque rapport utilise la requête de point de terminaison 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 d'activité d'audit de l'appareil ne peut être utilisé qu'à des fins légales, conformément à votre contrat client. Pour connaître les éditions qui incluent ces rapports, consultez Comparer les éditions Google Workspace.
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 de 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 les autorisations.
Pour en savoir plus sur les chaînes de requête et les propriétés de réponse de la requête, consultez la section É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
L'exemple suivant permet d'obtenir un rapport sur tous les événements d'audit des appareils de votre compte au cours des 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 permet d'obtenir un rapport sur tous les événements d'audit des appareils des 180 derniers jours. customerId spécifie le rapport du 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 récupérer des événements spécifiques, tels que les é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 des 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