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 parameter relational operator parameter 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": ""
}
]
}
]
}
]
}