Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 parameterrelational operatorparameter 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
{"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":""}]}]}]}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Admin Activity Report\n\nThe admin activity report returns information on the Admin console activities of all of your account's administrators. Each report uses the basic report endpoint request with report-specific parameters such as an administrator's name or a specific Admin console event. The maximum time period for each report is the last 180 days.\n\nThe admin activity report may be used only for lawful purposes in accordance with your Customer Agreement. And these reports apply to Google Workspace, Education, and ISP accounts.\n\nRetrieve all administrative activities\n--------------------------------------\n\nTo retrieve a report of all administrative activities done for an account, use the following `GET` HTTP request and include the authorization token described in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). For more information about the request's query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). For readability, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?endTime=a date&startTime=a date\n&maxResults=number of events listed on each page of the report\n```\n\nThe following example gets a report on all of your account's administrative activities for the past 180 days which is the maximum time period for a report. And the `maxResults` query string determines this report contains two events per report page. For an example of an API response, see the [JSON response example](#example_response): \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?maxResults=2\n```\n\nThe following example gets a report on all of a customer's administrative activities for the past 180 days. The `customerId` specifies which customer the report is to be retrieved for. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?customerId=C03az79cb\n```\n\nRetrieve all activities by administrator\n----------------------------------------\n\nTo retrieve a report of all Admin console activities done by a specific administrator, use the following `GET` HTTP request and include the authorization token described in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). The `userKey` is the primary email address of the administrator in the report. For more information about the request's query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). For readability, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey\n/applications/admin?endTime=a date&startTime=a date\n&maxResults=number of events listed on each page of the report\n&filters=event name parameter relational operator parameter value\n```\n\nThe following example gets a report on all changes to the Admin console application done by `john@example.com`, and the response is filtered to return any activities which have an `OLD_VALUE` equal to `ALLOW_CAMERA`. For an example of an API response, see the [JSON response example](#example_response). And for information about the activities, see the [administrator event names](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/admin-event-names): \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com\n/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA\n```\n\nRetrieve all activities by event name\n-------------------------------------\n\nTo retrieve a report of all activities for a specific event name, use the following `GET` HTTP request and include the authorization token described in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). For the `eventName` information, see the [administrator event names reference information](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/admin-event-names). For more information about the request's query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). For readability, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?endTime=a date&startTime=a date\n&maxResults=maximum number of events returned on a response page\n&eventName=name of the administrative event\n```\n\nThe following example retrieves a report for all Admin console instances of changing a user's last name. For an example of an API response, see the [JSON response example](#example_response): \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME\n```\n| **Note:** When retrieving by `eventName`, the API retrieves the activities where this event occurred. For each activity, the response includes all of the activity's events including the event specified in the API request.\n\nRetrieve all activities by event and administrator\n--------------------------------------------------\n\nTo retrieve a report of all Admin console changes for a specific event name done by a specific administrator, use the following `GET` HTTP request and include the authorization token described in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). The `userKey` is the primary email address of the administrator in the report. For the `eventName` information, see the [administrator event names reference information](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/admin-event-names). For more information about the request's query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). For readability, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey\n/applications/admin?endTime=a date&startTime=a date\n&maxResults=maximum number of events returned on a response page\n&eventName=name of the administrative event\n```\n\nThe following example retrieves a report for all Admin console changes to a specific user's last name that were done by `john@example.com`. For an example of an API response, see the [JSON response example](#example_response): \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com\n/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME\n```\n| **Note:** When retrieving by `eventName`, the API retrieves the activities where this event occurred. For each activity, the response includes all of the activity's events including the event specified in the API request.\n\nAdmin activity report example JSON response\n-------------------------------------------\n\nA successful response returns an [HTTP 200 status code](http://wikipedia.org/wiki/List_of_HTTP_status_codes). Along with the status code, the response returns a report. For the `eventName` information, see the [administrator event names reference information](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/admin-event-names). For more information about the request's URL query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). \n\n```carbon\n{\n \"kind\": \"reports#auditActivities\",\n \"nextPageToken\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003ethe next page's token\u003c/var\u003e\",\n \"items\": [\n {\n \"kind\": \"audit#activity\",\n \"id\": {\n \"time\": \"2011-06-17T15:39:18.460Z\",\n \"uniqueQualifier\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003ereport's unique ID\u003c/var\u003e\",\n \"applicationName\": \"admin\",\n \"customerId\": \"C03az79cb\"\n },\n \"actor\": {\n \"callerType\": \"USER\",\n \"email\": \"liz@example.com\",\n \"profileId\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003euser's unique Google Workspace profile ID\u003c/var\u003e\",\n \"key\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003econsumer key of requestor in OAuth 2LO requests\u003c/var\u003e\"\n },\n \"ownerDomain\": \"example.com\",\n \"ipAddress\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003euser's IP address\u003c/var\u003e\",\n \"events\": [\n {\n \"type\": \"GROUP_SETTINGS\",\n \"name\": \"CHANGE_GROUP_SETTING\",\n \"parameters\": [\n {\n \"name\": \"SETTING_NAME\",\n \"value\": \"WHO_CAN_JOIN\",\n \"intValue\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003einteger value of parameter\u003c/var\u003e\",\n \"boolValue\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003eboolean value of parameter\u003c/var\u003e\"\n }\n ]\n }\n ]\n },\n {\n \"kind\": \"audit#activity\",\n \"id\": {\n \"time\": \"2011-06-17T15:39:18.460Z\",\n \"uniqueQualifier\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003ereports unique ID\u003c/var\u003e\",\n \"applicationName\": \"admin\",\n \"customerId\": \"C03az79cb\"\n },\n \"actor\": {\n \"callerType\": \"USER\",\n \"email\": \"liz@example.com\",\n \"profileId\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003euser's unique Google Workspace profile ID\u003c/var\u003e\",\n \"key\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003econsumer key of requestor in an OAuth 2LO request\u003c/var\u003e\"\n },\n \"ownerDomain\": \"example.com\",\n \"ipAddress\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003euser's IP address\u003c/var\u003e\",\n \"events\": [\n {\n \"type\": \"GROUP_SETTINGS\",\n \"name\": \"CREATE_GROUP\",\n \"parameters\": [\n {\n \"name\": \"GROUP_EMAIL\",\n \"value\": \"helpdesk@example.com\",\n \"intValue\": \"\",\n \"boolValue\": \"\"\n }\n ]\n }\n ]\n }\n ]\n }\n```"]]
