Le rapport sur les connexions renvoie des informations sur les connexions de toutes les les utilisateurs de votre compte. Chaque rapport utilise la demande de point de terminaison de base avec paramètres propres au rapport, tels que l'adresse e-mail de l'utilisateur. La la période maximale de chaque rapport correspond aux 180 derniers jours.
Le rapport sur les connexions ne peut être utilisé qu'à des fins légales, conformément à votre contrat client.
Récupérer les événements de connexion Google Workspace d'un domaine
Pour récupérer toutes les connexions de tous les services de votre domaine, utilisez le code suivant :
GET et inclure le jeton d'autorisation décrit dans la
documents d'autorisation.
Pour en savoir plus sur les chaînes de requête
et les propriétés de réponse,
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
Dans l'exemple suivant, la requête permet d'obtenir un rapport sur tous les événements de connexion de votre compte pour
au cours des 180 derniers jours. Ce rapport renvoie le paramètre de requête maxResults
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 pour
au cours des 180 derniers jours. Le customerId indique le client concerné par le rapport.
à récupérer.
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
les événements,
telles que les connexions réussies suspectes. Pour ce faire, utilisez une requête HTTP GET de
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