Отчет о деятельности администратора

Отчет о действиях администратора содержит информацию о действиях в консоли администратора всех администраторов вашего аккаунта. В каждом отчете используется базовый запрос конечной точки отчета с параметрами, специфичными для отчета, такими как имя администратора или определенное событие консоли администратора. Максимальный период времени для каждого отчета — последние 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 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": ""
       }
      ]
     }
    ]
   }
  ]
 }