Le rapport sur l'activité de connexion fournit 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 licites, 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 pour 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 l'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 documentation de référence de l'API.
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/login?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 de connexion de votre compte au cours des 180 derniers jours. Le paramètre de requête maxResults permet à ce rapport de renvoyer 25 résultats par page.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
L'exemple suivant obtient 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 souhaiter 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