Rapport sur les activités d'administration

Le rapport sur les activités d'administration contient 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 pour chaque rapport est de 180 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 en savoir plus sur les chaînes de requête de la requête et les propriétés de la 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 génère un rapport sur toutes les activités d'administration de votre compte enregistrées 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 génère un rapport sur toutes les activités d'administration d'un client pour les 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 spécifique, 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 les chaînes de requête de la requête et les propriétés de la 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

L'exemple suivant génère 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 l'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 d'événements de l'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 les autorisations. Pour en savoir plus sur eventName, consultez les informations de référence sur les noms d'événements de l'administrateur. Pour en savoir plus sur les chaînes de requête de la requête et les propriétés de la 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 récupère un rapport pour toutes les instances de modification du nom d'un utilisateur dans 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 de toutes les modifications apportées par la console d'administration à un nom d'événement spécifique par un administrateur, 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 de référence sur les noms d'événements de l'administrateur. Pour en savoir plus sur les chaînes de requête de la requête et les propriétés de la 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

L'exemple suivant récupère un rapport concernant toutes les modifications apportées par john@example.com au nom d'un utilisateur spécifique dans 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/john@example.com
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

Exemple de réponse JSON d'un rapport sur les activités d'administration

Les appels réussis renvoient un code d'état HTTP 200. Avec 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 d'événements de l'administrateur. Pour en savoir plus sur les chaînes de requête d'URL et les propriétés de réponse de la requête, 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": ""
       }
      ]
     }
    ]
   }
  ]
 }