Le rapport sur l'activité de l'audit de l'appareil fournit des informations sur les activités de tous les appareils gérés par la gestion des points de terminaison Google. 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 correspond aux 180 derniers jours.
Le rapport sur l'activité d'audit de l'appareil ne peut être utilisé qu'à des fins licites, 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 d'autorisation.
Pour en savoir plus sur les chaînes de requête de requête et les propriétés de réponse, consultez la section Événements d'activité d'audit de l'appareil.
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 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 obtient un rapport sur tous les événements d'audit de l'appareil au cours des 180 derniers jours. customerId spécifie le rapport du client qui est récupéré.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb
Récupérer des é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