Le rapport "Activité d'administration" fournit des informations sur les activités de la console d'administration de tous les administrateurs de votre compte. Chaque rapport utilise la demande 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 de chaque rapport correspond aux 180 derniers jours.
Le rapport sur les activités d'administration ne peut être utilisé qu'à des fins légales, conformément à votre contrat client. Ces rapports s'appliquent aux comptes Google Workspace, Education et ISP.
Récupérer toutes les activités d'administration
Pour récupérer un rapport de toutes les activités d'administration effectuées pour un compte, utilisez la requête HTTP GET suivante et incluez le jeton d'autorisation décrit dans la documentation sur les autorisations. Pour plus d'informations sur les chaînes de requête de la 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/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report
Dans l'exemple suivant, la requête permet de générer un rapport sur toutes les activités d'administration de votre compte au cours des 180 derniers jours, ce qui correspond à la période maximale pour un rapport. Et la chaîne de requête maxResults détermine que ce rapport contient deux événements par page du rapport. Pour obtenir un exemple de réponse d'API, consultez l'exemple de réponse JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
Dans l'exemple suivant, la requête permet d'obtenir un rapport sur toutes les activités d'administration d'un client au cours des 180 derniers jours. Le champ customerId indique pour quel client 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 l'administrateur
Pour récupérer un rapport de toutes les activités de la console d'administration effectuées par un administrateur donné, utilisez la requête HTTP GET suivante et incluez le jeton d'autorisation décrit dans la documentation sur les autorisations. userKey est l'adresse e-mail principale de l'administrateur dans le rapport. Pour plus d'informations sur les chaînes de requête de la 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/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
Dans l'exemple suivant, le rapport génère un rapport sur toutes les modifications apportées par john@example.com à l'application de la console d'administration. 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 plus d'informations sur les activités, consultez les noms des événements pour les administrateurs:
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 sur 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 les autorisations. Pour en savoir plus sur eventName, consultez les informations sur les noms d'événements d'administrateur. Pour plus d'informations sur les chaînes de requête de la 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/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 permet de récupérer un rapport sur la modification du nom d'un utilisateur pour toutes les instances de la console d'administration. Pour obtenir un exemple de réponse d'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 par administrateur
Pour récupérer un rapport sur toutes les modifications apportées par un administrateur à un nom d'événement spécifique dans la console d'administration, utilisez la requête HTTP GET suivante et incluez le jeton d'autorisation décrit dans la documentation sur les autorisations. userKey est l'adresse e-mail principale de l'administrateur dans le rapport. Pour en savoir plus sur eventName, consultez les informations sur les noms d'événements d'administrateur. Pour plus d'informations sur les chaînes de requête de la 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/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
Dans l'exemple suivant, l'utilisateur peut récupérer un rapport sur toutes les modifications apportées dans la console d'administration par john@example.com sur le nom d'un utilisateur spécifique. Pour obtenir un exemple de réponse d'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 concernant le rapport sur les activités d'administration
Les réponses positives affichent un code d'état HTTP 200. En plus du code d'état, la réponse renvoie un rapport. Pour en savoir plus sur eventName, consultez les informations sur les noms d'événements d'administrateur. Pour plus d'informations sur les chaînes de requête d'URL de la requête et les propriétés de 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 requestor 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 requestor 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": "" } ] } ] } ] }