Отчет об активности администратора возвращает информацию о действиях в консоли администратора всех администраторов вашей учетной записи. Каждый отчет использует базовый запрос конечной точки отчета с параметрами, специфичными для отчета, такими как имя администратора или конкретное событие в консоли администратора. Максимальный период времени для каждого отчета составляет последние 180 дней.
Отчет об административной активности может использоваться только в законных целях в соответствии с вашим клиентским соглашением. Эти отчеты применяются к учетным записям Google Workspace, Education и ISP.
Получить все административные данные
Чтобы получить отчет обо всех административных действиях, выполненных для учетной записи, используйте следующий HTTP-запрос GET и укажите токен авторизации, описанный в документации по авторизации . Дополнительную информацию о параметрах запроса и свойствах ответа см. в Справочнике API . Для удобства чтения следующий пример отформатирован с использованием переносов строк:
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
В следующем примере получается отчет обо всех административных действиях вашей учетной записи за последние 180 дней, что является максимальным периодом для отчета. Строка запроса maxResults определяет, что каждый отчет содержит два события на странице. Пример ответа API см. в примере ответа JSON :
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
В следующем примере получается отчет обо всех административных действиях клиента за последние 180 дней. Параметр customerId указывает, для какого клиента необходимо получить отчет.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Получить все действия, совершенные администратором.
Чтобы получить отчет обо всех действиях в консоли администратора, выполненных конкретным администратором, используйте следующий HTTP-запрос GET и укажите токен авторизации, описанный в документации по авторизации . userKey — это основной адрес электронной почты администратора, указанного в отчете. Для получения дополнительной информации о параметрах запроса и свойствах ответа см. Справочник API . Для удобства чтения следующий пример отформатирован с использованием переносов строк:
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
В следующем примере запрашивается отчет обо всех изменениях в приложении административной консоли, внесенных пользователем john@example.com , а ответ фильтруется таким образом, чтобы возвращались все действия, у которых значение OLD_VALUE равно ALLOW_CAMERA . Пример ответа API см. в примере ответа JSON . А информацию о действиях см. в названиях событий администратора :
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Получить все мероприятия по названию события.
Чтобы получить отчет обо всех действиях для определенного имени события, используйте следующий HTTP-запрос GET и укажите токен авторизации, описанный в документации по авторизации . Информацию об eventName см. в справочной информации по именам событий администратора . Дополнительную информацию о параметрах запроса и свойствах ответа см. в справочнике API . Для удобства чтения следующий пример отформатирован с использованием переносов строк:
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
В следующем примере получен отчет по всем случаям изменения фамилии пользователя в консоли администратора. Пример ответа API см. в примере ответа в формате JSON :
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Получить все события по каждому администратору.
Чтобы получить отчет обо всех изменениях в консоли администратора, внесенных конкретным администратором для определенного имени события, используйте следующий HTTP-запрос GET и включите токен авторизации, описанный в документации по авторизации . userKey — это основной адрес электронной почты администратора в отчете. Информацию об eventName см. в справочной информации по именам событий администратора . Дополнительную информацию о параметрах запроса и свойствах ответа см. в справочнике API . Для удобства чтения следующий пример отформатирован с использованием переносов строк:
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
В следующем примере получен отчет обо всех изменениях фамилии конкретного пользователя в консоли администратора, внесенных пользователем john@example.com . Пример ответа API см. в примере ответа в формате JSON :
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Пример JSON-ответа к отчету об административной активности
В случае успешного ответа возвращается код состояния HTTP 200. Вместе с кодом состояния ответ возвращает отчет. Информацию об eventName см. в справочнике по именам событий администратора . Дополнительную информацию о строках запроса URL и свойствах ответа см. в справочнике 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 requester 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 requester 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": "" } ] } ] } ] }