Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Der Bericht zu Administratoraktivitäten enthält Informationen zu den Aktivitäten aller Administratoren Ihres Kontos in der Admin-Konsole. Für jeden Bericht wird die grundlegende Anfrage für den Berichtsendpunkt mit berichtsspezifischen Parametern wie dem Namen eines Administrators oder einem bestimmten Ereignis in der Admin-Konsole verwendet. Der maximale Zeitraum für jeden Bericht umfasst die letzten 180 Tage.
Der Bericht zu Administratoraktivitäten darf nur zu rechtmäßigen Zwecken gemäß Ihrer Kundenvereinbarung verwendet werden. Diese Berichte gelten für Google Workspace-, Education- und ISP-Konten.
Alle administrativen Aktivitäten abrufen
Um einen Bericht über alle für ein Konto durchgeführten Verwaltungsaktivitäten abzurufen, verwenden Sie die folgende GET-HTTP-Anfrage und fügen Sie das in der Autorisierungsdokumentation beschriebene Autorisierungstoken ein. Weitere Informationen zu den Abfragestrings und den Antworteigenschaften der Anfrage finden Sie in der API-Referenz. Zur besseren Lesbarkeit wurde das folgende Beispiel mit Zeilen zurückgeliefert:
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
Im folgenden Beispiel wird ein Bericht zu allen Verwaltungsaktivitäten Ihres Kontos in den letzten 180 Tagen abgerufen. Dies ist der maximale Zeitraum für einen Bericht. Und der Abfragestring maxResults gibt an, dass dieser Bericht zwei Ereignisse pro Berichtsseite enthält. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine JSON-Antwort:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=2
Im folgenden Beispiel wird ein Bericht über alle Verwaltungsaktivitäten eines Kunden in den letzten 180 Tagen abgerufen. Das customerId gibt an, für welchen Kunden der Bericht abgerufen werden soll.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?customerId=C03az79cb
Alle Aktivitäten nach Administrator abrufen
Um einen Bericht über alle Aktivitäten in der Admin-Konsole abzurufen, die von einem bestimmten Administrator ausgeführt wurden, verwenden Sie die folgende GET-HTTP-Anfrage und fügen Sie das in der Autorisierungsdokumentation beschriebene Autorisierungstoken ein. userKey ist die primäre E-Mail-Adresse des Administrators im Bericht. Weitere Informationen zu den Abfragestrings und den Antworteigenschaften der Anfrage finden Sie in der API-Referenz. Zur besseren Lesbarkeit wurde das folgende Beispiel mit Zeilen zurückgeliefert:
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
Im folgenden Beispiel wird ein Bericht über alle Änderungen an der Anwendung in der Admin-Konsole abgerufen, die von john@example.com vorgenommen wurden. Die Antwort wird so gefiltert, dass alle Aktivitäten zurückgegeben werden, bei denen ein OLD_VALUE gleich ALLOW_CAMERA ist. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine JSON-Antwort. Informationen zu den Aktivitäten finden Sie unter Administratorereignisnamen:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Alle Aktivitäten nach Ereignisname abrufen
Verwenden Sie die folgende GET-HTTP-Anfrage und fügen Sie das in der Autorisierungsdokumentation beschriebene Autorisierungstoken ein, um einen Bericht über alle Aktivitäten für einen bestimmten Ereignisnamen abzurufen. Die Informationen zu eventName finden Sie unter Referenz zu Administrator-Ereignisnamen. Weitere Informationen zu den Abfragestrings und den Antworteigenschaften der Anfrage finden Sie in der API-Referenz. Zur besseren Lesbarkeit wurde das folgende Beispiel mit Zeilen zurückgeliefert:
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
Im folgenden Beispiel wird ein Bericht für alle Instanzen der Änderung des Nachnamens eines Nutzers in der Admin-Konsole abgerufen. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine JSON-Antwort:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Alle Aktivitäten nach Ereignis und Administrator abrufen
Um einen Bericht über alle Änderungen in der Admin-Konsole für einen bestimmten Ereignisnamen abzurufen, die von einem bestimmten Administrator vorgenommen wurden, verwenden Sie die folgende GET-HTTP-Anfrage und fügen Sie das in der Autorisierungsdokumentation beschriebene Autorisierungstoken ein. userKey ist die primäre E-Mail-Adresse des Administrators im Bericht. Die Informationen zu eventName finden Sie unter Referenz zu Administrator-Ereignisnamen. Weitere Informationen zu den Abfragestrings und den Antworteigenschaften der Anfrage finden Sie in der API-Referenz. Zur besseren Lesbarkeit wurde das folgende Beispiel mit Zeilen zurückgeliefert:
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
Im folgenden Beispiel wird ein Bericht für alle Änderungen am Nachnamen eines bestimmten Nutzers in der Admin-Konsole abgerufen, die von john@example.com vorgenommen wurden. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine JSON-Antwort:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Beispiel für eine JSON-Antwort für einen Bericht zur Administratoraktivität
Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben. Zusammen mit dem Statuscode wird in der Antwort ein Bericht zurückgegeben. Die Informationen zu eventName finden Sie unter Referenz zu Administrator-Ereignisnamen. Weitere Informationen zu den URL-Abfragestrings der Anfrage und den Antwortattributen finden Sie in der API-Referenz.
{"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":""}]}]}]}
[null,null,["Zuletzt aktualisiert: 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```"]]
