Le rapport sur l'activité des administrateurs renvoie des informations sur les activités dans la console d'administration de tous les administrateurs 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 le nom d'un administrateur ou un événement spécifique de la console d'administration. La période maximale pour chaque rapport est de 180 jours.
Le rapport sur l'activité des administrateurs ne peut être utilisé qu'à des fins légales, conformément à votre contrat client. Ces rapports s'appliquent aux comptes Google Workspace, Education et FAI.
Récupérer toutes les activités administratives
Pour récupérer un rapport de toutes les activités administratives effectuées pour un compte, 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 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/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report
L'exemple suivant permet d'obtenir un rapport sur toutes les activités administratives de votre compte au cours des 180 derniers jours, qui correspond à la période maximale pour un rapport.
La chaîne de requête maxResults détermine que ce rapport contient deux événements par page. Pour obtenir un exemple de réponse de l'API, consultez l'exemple de réponse JSON :
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
L'exemple suivant permet d'obtenir un rapport sur toutes les activités administratives 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/admin?customerId=C03az79cb
Récupérer toutes les activités par administrateur
Pour récupérer un rapport de toutes les activités de la console d'administration effectuées par un administrateur spécifique, utilisez la requête HTTP GET suivante et incluez le jeton d'autorisation décrit dans la documentation sur l'autorisation. userKey correspond à l'adresse e-mail principale de l'administrateur dans le rapport. 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 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/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report &filters=event name parameter relational operator parameter value
L'exemple suivant obtient un rapport sur toutes les modifications apportées à l'application de la console d'administration par john@example.com. La réponse est filtrée pour renvoyer toutes les activités dont le OLD_VALUE est égal à ALLOW_CAMERA. Pour obtenir un exemple de réponse d'API, consultez l'exemple de réponse JSON.
Pour en savoir plus sur les activités, consultez les noms des événements administrateur :
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Récupérer toutes les activités par nom d'événement
Pour récupérer un rapport de toutes les activités pour un nom d'événement spécifique, 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 eventName, consultez les informations de référence sur les noms des événements d'administrateur. 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 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/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
L'exemple suivant récupère un rapport pour toutes les instances de la console d'administration où le nom de famille d'un utilisateur a été modifié. Pour obtenir un exemple de réponse de l'API, consultez l'exemple de réponse JSON :
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Récupérer toutes les activités par événement et administrateur
Pour récupérer un rapport de toutes les modifications apportées à la console d'administration pour un nom d'événement spécifique par un administrateur spécifique, utilisez la requête HTTP GET suivante et incluez le jeton d'autorisation décrit dans la documentation sur l'autorisation. userKey correspond à l'adresse e-mail principale de l'administrateur dans le rapport. Pour en savoir plus sur eventName, consultez les informations de référence sur les noms des événements d'administrateur. 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 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/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
L'exemple suivant récupère un rapport sur toutes les modifications apportées au nom de famille d'un utilisateur spécifique dans la console d'administration par john@example.com. Pour obtenir un exemple de réponse de l'API, consultez l'exemple de réponse JSON :
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Exemple de réponse JSON du rapport sur l'activité d'administration
Une réponse réussie renvoie un code d'état HTTP 200.
Outre le code d'état, la réponse renvoie un rapport. Pour en savoir plus sur eventName, consultez les informations de référence sur les noms des événements d'administrateur. Pour en savoir plus sur les chaînes de requête de l'URL de la requête et sur les propriétés de la réponse, consultez la documentation de référence de l'API.
{ "kind": "reports#auditActivities", "nextPageToken": "the next page's token", "items": [ { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "report's unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requester in OAuth 2LO requests" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CHANGE_GROUP_SETTING", "parameters": [ { "name": "SETTING_NAME", "value": "WHO_CAN_JOIN", "intValue": "integer value of parameter", "boolValue": "boolean value of parameter" } ] } ] }, { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "reports unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requester in an OAuth 2LO request" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CREATE_GROUP", "parameters": [ { "name": "GROUP_EMAIL", "value": "helpdesk@example.com", "intValue": "", "boolValue": "" } ] } ] } ] }