Le rapport sur les activités de connexion renvoie des informations sur les activités de connexion de tous les utilisateurs de votre compte. 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 sur l'activité de connexion ne peut être utilisé qu'à des fins légales, conformément à votre contrat client.
Récupérer les événements de connexion Google Workspace pour un domaine
Pour récupérer toutes les connexions de tous les services 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 documentation de référence de l'API.
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/login?endTime=end date&startTime=start date &maxResults=maximum number of events returned on a response page
L'exemple suivant génère un rapport sur tous les événements de connexion de votre compte au cours des 180 derniers jours. Selon le paramètre de requête maxResults, ce rapport renvoie 25 résultats par page.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
L'exemple suivant permet d'obtenir un rapport sur tous les événements de connexion d'un client au cours des 180 derniers jours. customerId spécifie le client pour lequel le rapport doit être récupéré.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
Récupérer les événements de connexion Google Workspace par nom d'événement
Dans certains cas, vous pouvez récupérer des événements spécifiques, tels que des connexions réussies suspectes. Pour ce faire, utilisez une requête HTTP GET au format suivant:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?maxResults=maximum number of events returned on a response page &eventName=name of the login event &filters=event parameter relational operator parameter value
L'exemple suivant montre comment récupérer toutes les connexions réussies suspectes pour un domaine:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25