Method: activities.list

Получает список действий для учетной записи и приложения конкретного клиента, например приложения консоли администратора или приложения Google Drive. Дополнительную информацию см. в руководствах для администраторов и отчетах об активности на Google Диске . Дополнительную информацию о параметрах отчета о активности см. в справочных руководствах по параметрам активности .

HTTP-запрос

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
userKey or all

string

Представляет идентификатор профиля или адрес электронной почты пользователя, данные для которого следует фильтровать. Это может быть all для всей информации или userKey для уникального идентификатора профиля пользователя Google Workspace или его основного адреса электронной почты. Не должен быть удаленным пользователем. Для удаленного пользователя вызовите users.list в Directory API с помощью showDeleted=true , а затем используйте возвращенный ID в качестве userKey .

applicationName

enum ( ApplicationName )

Имя приложения, для которого необходимо получить события.

Параметры запроса

Параметры
actorIpAddress

string

Адрес интернет-протокола (IP) хоста, на котором было выполнено событие. Это дополнительный способ фильтрации сводки отчета по IP-адресу пользователя, о деятельности которого сообщается. Этот IP-адрес может отражать или не отражать физическое местоположение пользователя. Например, IP-адрес может быть адресом прокси-сервера пользователя или адресом виртуальной частной сети (VPN). Этот параметр поддерживает версии адресов IPv4 и IPv6 .

customerId

string

Уникальный идентификатор клиента, для которого требуется получить данные.

endTime

string

Устанавливает конец диапазона времени, отображаемого в отчете. Дата имеет формат RFC 3339 , например 2010-10-28T10:26:35.000Z. Значение по умолчанию — приблизительное время запроса API. Отчет API имеет три основные концепции времени:

  • Дата запроса API на отчет : когда API создал и получил отчет.
  • Время начала отчета : начало периода времени, показанного в отчете. startTime должно быть раньше endTime (если указано) и текущего времени выполнения запроса, иначе API вернет ошибку.
  • Время окончания отчета : окончание периода времени, указанного в отчете. Например, временной интервал событий, суммированных в отчете, может начинаться в апреле и заканчиваться в мае. Сам отчет можно запросить в августе.
Если endTime не указан, отчет возвращает все действия с startTime до текущего времени или за последние 180 дней, если startTime прошло более 180 дней.

eventName

string

Имя события, запрашиваемого API. Каждое eventName связано с определенной службой или функцией Google Workspace, которую API группирует по типам событий. Примером могут служить события Календаря Google в отчетах приложения консоли администратора. Структура type «Настройки календаря» содержит все действия Calendar eventName , о которых сообщает API. Когда администратор изменяет настройку календаря, API сообщает об этом в параметрах type Settings Calendar и eventName . Дополнительные сведения о строках и параметрах запроса eventName см. в списке имен событий для различных приложений выше в applicationName .

filters

string

Строка запроса filters представляет собой список, разделенный запятыми, состоящий из параметров событий, которыми управляют операторы отношения. Параметры события имеют форму {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

Эти параметры события связаны с определенным eventName . Пустой отчет возвращается, если параметр запроса не принадлежит eventName . Для получения дополнительной информации о доступных полях eventName для каждого приложения и связанных с ними параметрах перейдите к таблице ApplicationName , затем перейдите на страницу «События активности» в приложении для нужного приложения.

В следующих примерах действий Диска возвращаемый список состоит из всех событий edit , в которых значение параметра doc_id соответствует условиям, определенным оператором отношения. В первом примере запрос возвращает все редактируемые документы со значением doc_id , равным 12345 . Во втором примере отчет возвращает все отредактированные документы, в которых значение doc_id не равно 98765 . Оператор <> закодирован в URL-адресе в строке запроса запроса ( %3C%3E ):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

Запрос filters поддерживает следующие операторы отношения:

  • == —'равно'.
  • <> —'не равно'. Должен быть закодирован в URL-адресе (%3C%3E).
  • < — «меньше чем». Должно быть закодировано в URL-адресе (%3C).
  • <= —'меньше или равно'. Должно быть закодировано в URL-адресе (%3C=).
  • > «больше чем». Должно быть закодировано в URL-адресе (%3E).
  • >= —'больше или равно'. Должно быть закодировано в URL-адресе (%3E=).

Примечание. API не принимает несколько значений одного и того же параметра. Если параметр указан в запросе API более одного раза, API принимает только последнее значение этого параметра. Кроме того, если в запросе API указан недопустимый параметр, API игнорирует этот параметр и возвращает ответ, соответствующий остальным допустимым параметрам. Если никакие параметры не запрошены, возвращаются все параметры.

maxResults

integer

Определяет, сколько записей активности отображается на каждой странице ответа. Например, если запрос устанавливает maxResults=1 и в отчете есть два действия, отчет будет состоять из двух страниц. Свойство nextPageToken ответа содержит токен второй страницы. Строка запроса maxResults не является обязательной в запросе. Значение по умолчанию — 1000.

orgUnitID

string

Идентификатор организационного подразделения , о котором нужно сообщить. Записи активности будут показаны только для пользователей, принадлежащих к указанному организационному подразделению.

pageToken

string

Токен для указания следующей страницы. Отчет с несколькими страницами имеет в ответе свойство nextPageToken . В последующем запросе на получение следующей страницы отчета введите значение nextPageToken в строке запроса pageToken .

startTime

string

Устанавливает начало диапазона времени, отображаемого в отчете. Дата имеет формат RFC 3339 , например 2010-10-28T10:26:35.000Z. Отчет возвращает все действия с startTime до endTime . startTime должно быть раньше endTime (если указано) и текущего времени выполнения запроса, иначе API вернет ошибку.

groupIdFilter

string

Идентификаторы групп, разделенные запятыми (замаскированные), по которым фильтруются действия пользователей, т. е. ответ будет содержать действия только тех пользователей, которые являются частью хотя бы одного из упомянутых здесь идентификаторов групп. Формат: «идентификатор: abc123, идентификатор: xyz456»

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Шаблон JSON для набора действий.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
Поля
kind

string

Тип ресурса API. Для отчета о деятельности значением является reports#activities .

etag

string

ETag ресурса.

items[]

object ( Activity )

Каждое действие записывается в ответе.

nextPageToken

string

Токен для получения следующей страницы отчета. Значение nextPageToken используется в строке запроса pageToken запроса.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Дополнительную информацию см. в руководстве по авторизации .

Имя приложения

Перечисления
access_transparency

Отчеты о действиях прозрачности доступа Google Workspace возвращают информацию о различных типах событий, связанных с прозрачностью доступа .

admin

Отчеты о деятельности приложения консоли администратора возвращают информацию об учетной записи о различных типах событий активности администратора .

calendar

Отчеты об активности приложения Календарь Google возвращают информацию о различных событиях активности Календаря .

chat

Отчеты об активности чата возвращают информацию о различных событиях активности чата .

drive

Отчеты об активности приложения Google Диск возвращают информацию о различных событиях активности на Google Диске . Отчет о действиях на Диске доступен только для клиентов Google Workspace Business и Enterprise.

gcp

Отчеты об активности приложения Google Cloud Platform возвращают информацию о различных событиях активности GCP .

gplus

Отчеты об активности приложения Google+ возвращают информацию о различных событиях активности Google+ .

groups

Отчеты об активности приложения Google Groups возвращают информацию о различных событиях активности в группах .

groups_enterprise

Отчеты о деятельности групп предприятий возвращают информацию о различных событиях активности групп предприятий .

jamboard

Отчеты об активности Jamboard возвращают информацию о различных событиях активности Jamboard .

login

Отчеты о действиях приложения входа в систему возвращают информацию об учетной записи о различных типах событий активности входа в систему .

meet

Отчет о деятельности Meet Audit возвращает информацию о различных типах событий активности Meet Audit .

mobile

Отчет о деятельности аудита устройств возвращает информацию о различных типах событий активности аудита устройств .

rules

Отчет об активности правил возвращает информацию о различных типах событий активности правил .

saml

Отчет о деятельности SAML возвращает информацию о различных типах событий активности SAML .

token

Отчеты о деятельности приложения Token возвращают информацию об учетной записи о различных типах событий активности Token .

user_accounts

Отчеты об активности приложения «Учетные записи пользователей» возвращают информацию об учетной записи о различных типах событий активности учетных записей пользователей .

context_aware_access

Отчеты о действиях контекстно-зависимого доступа возвращают информацию о событиях, когда пользователям было отказано в доступе из-за правил контекстно-зависимого доступа .

chrome

Отчеты об активности Chrome возвращают информацию о событиях браузера Chrome и Chrome OS .

data_studio

Отчеты о деятельности Студии данных возвращают информацию о различных типах событий активности Студии данных .

keep

Отчеты об активности приложения Keep возвращают информацию о различных событиях активности Google Keep . Отчет о действиях Keep доступен только для клиентов Google Workspace Business и Enterprise.

vault Отчеты о действиях Vault возвращают информацию о различных типах событий активности Vault.

Активность

Шаблон JSON для ресурса действия.

JSON-представление 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string,
    "applicationInfo": {
      "oauthClientId": string,
      "applicationName": string,
      "impersonation": boolean
    }
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ]
}
Поля
kind

string

Тип ресурса API. Для отчета о деятельности значением является audit#activity .

etag

string

ETag записи.

ownerDomain

string

Это домен, на который влияет событие отчета. Например, домен консоли администратора или владелец документа приложения Диска.

ipAddress

string

IP-адрес пользователя, выполняющего действие. Это IP-адрес пользователя при входе в Google Workspace, который может отражать или не отражать физическое местоположение пользователя. Например, IP-адрес может быть адресом прокси-сервера пользователя или адресом виртуальной частной сети (VPN). API поддерживает IPv4 и IPv6 .

events[]

object

События активности в отчете.

events[].type

string

Тип мероприятия. Служба или функция Google Workspace, которую изменяет администратор, определяется в свойстве type , которое идентифицирует событие с помощью свойства eventName . Полный список категорий type API см. в списке имен событий для различных приложений выше в applicationName .

events[].name

string

Название мероприятия. Это конкретное имя действия, о котором сообщает API. Каждое eventName связано с конкретной службой или функцией Google Workspace, которую API группирует по типам событий.
Для параметров запроса eventName в целом:

  • Если eventName не указано, отчет возвращает все возможные экземпляры eventName .
  • Когда вы запрашиваете eventName , ответ API возвращает все действия, содержащие это eventName .

Дополнительные сведения о свойствах eventName см. в списке имен событий для различных приложений выше в applicationName .

events[].parameters[]

object

Пары значений параметров для различных приложений. Дополнительные сведения о параметрах eventName см. в списке имен событий для различных приложений выше в applicationName .

events[].parameters[].messageValue

object

Пары значений вложенных параметров, связанные с этим параметром. Комплексный тип значения параметра возвращается в виде списка значений параметра. Например, параметр адреса может иметь значение как [{parameter: [{name: city, value: abc}]}]

events[].parameters[].messageValue.parameter[]

object ( NestedParameter )

Значения параметров

events[].parameters[].name

string

Имя параметра.

events[].parameters[].value

string

Строковое значение параметра.

events[].parameters[].multiValue[]

string

Строковые значения параметра.

events[].parameters[].intValue

string ( int64 format)

Целочисленное значение параметра.

events[].parameters[].multiIntValue[]

string ( int64 format)

Целочисленные значения параметра.

events[].parameters[].boolValue

boolean

Логическое значение параметра.

events[].parameters[].multiMessageValue[]

object

активностей.список объектов messageValue .

events[].parameters[].multiMessageValue[].parameter[]

object ( NestedParameter )

Значения параметров

events[].resourceIds[]

string

Идентификаторы ресурсов, связанные с событием.

id

object

Уникальный идентификатор для каждой записи активности.

id.time

string

Время возникновения активности. Это время эпохи UNIX в секундах.

id.uniqueQualifier

string ( int64 format)

Уникальный квалификатор, если несколько событий происходят в одно и то же время.

id.applicationName

string

Имя приложения, которому принадлежит событие. Возможные значения см. в списке приложений выше в applicationName .

id.customerId

string

Уникальный идентификатор аккаунта Google Workspace.

actor

object

Пользователь выполняет действие.

actor.profileId

string

Уникальный идентификатор профиля актера в Google Workspace. Это значение может отсутствовать, если актер не является пользователем Google Workspace, или может быть номером 105250506097979753968, который действует как идентификатор-заполнитель.

actor.email

string

Основной адрес электронной почты актера. Может отсутствовать, если с актером не связан адрес электронной почты.

actor.callerType

string

Тип актера.

actor.key

string

Присутствует только тогда, когда callerType имеет значение KEY . Может быть consumer_key отправителя запроса для запросов API OAuth 2LO или идентификатором для учетных записей роботов.

actor.applicationInfo

object

Подробная информация о приложении, которое было исполнителем действия.

actor.applicationInfo.oauthClientId

string

Идентификатор клиента OAuth стороннего приложения, используемого для выполнения действия.

actor.applicationInfo.applicationName

string

Имя приложения, используемого для выполнения действия.

actor.applicationInfo.impersonation

boolean

Выдавало ли приложение себя за пользователя.

resourceDetails[]

object ( ResourceDetails )

Подробности о ресурсе, на котором было выполнено действие.

Детали ресурса

Подробности о ресурсе, на котором было выполнено действие.

JSON-представление 
{
  "id": string,
  "title": string,
  "type": string,
  "appliedLabels": [
    {
      object (AppliedLabel)
    }
  ],
  "relation": string
}
Поля
id

string

Идентификатор ресурса.

title

string

Название ресурса. Например, в случае документа на Диске это будет заголовок документа. В случае электронного письма это будет тема.

type

string

Тип ресурса — документ, электронная почта, сообщение чата.

appliedLabels[]

object ( AppliedLabel )

активности.список меток, примененных к ресурсу

relation

string

Определяет связь ресурса с событиями

Прикладная метка

Подробности метки, примененной к ресурсу.

JSON-представление 
{
  "id": string,
  "title": string,
  "fieldValues": [
    {
      object (FieldValue)
    }
  ],
  "reason": {
    object (Reason)
  }
}
Поля
id

string

Идентификатор метки — только идентификатор метки, а не полное имя ресурса OnePlatform.

title

string

Название этикетки

fieldValues[]

object ( FieldValue )

активностей.список полей, которые являются частью метки и заданы пользователем. Если в метке есть поле, которое не было задано пользователем, оно не будет присутствовать в этом списке.

reason

object ( Reason )

Причина, по которой метка была применена к ресурсу.

ПолеValue

Подробная информация о значении поля, установленном пользователем для конкретной метки.

JSON-представление 
{
  "id": string,
  "displayName": string,
  "type": string,
  "reason": {
    object (Reason)
  },

  // Union field value can be only one of the following:
  "unsetValue": boolean,
  "longTextValue": string,
  "textValue": string,
  "textListValue": {
    object (TextListValue)
  },
  "selectionValue": {
    object (SelectionValue)
  },
  "selectionListValue": {
    object (SelectionListValue)
  },
  "integerValue": string,
  "userValue": {
    object (UserValue)
  },
  "userListValue": {
    object (UserListValue)
  },
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
Поля
id

string

Идентификатор поля

displayName

string

Отображаемое имя поля

type

string

Тип поля

reason

object ( Reason )

Причина, по которой поле было применено к метке.

value поля объединения. Хранит значения, хранящиеся в поле value может быть только одно из следующих:
unsetValue

boolean

Если поле не установлено, это будет правдой.

longTextValue

string

Установка длинного текстового значения.

textValue

string

Установка текстового значения.

textListValue

object ( TextListValue )

Установка значения текстового списка.

selectionValue

object ( SelectionValue )

Установка значения выбора путем выбора одного значения из раскрывающегося списка.

selectionListValue

object ( SelectionListValue )

Установка значения списка выбора путем выбора нескольких значений из раскрывающегося списка.

integerValue

string ( int64 format)

Установка целочисленного значения.

userValue

object ( UserValue )

Установка значения пользователя путем выбора одного пользователя.

userListValue

object ( UserListValue )

Установка значения списка пользователей путем выбора нескольких пользователей.

dateValue

object ( Date )

Установка значения даты.

Текстлиствалуе

Установка значения текстового списка.

JSON-представление 
{
  "values": [
    string
  ]
}
Поля
values[]

string

активности.список текстовых значений.

ВыборЗначение

Установка значения выбора путем выбора одного значения из раскрывающегося списка.

JSON-представление 
{
  "id": string,
  "displayName": string,
  "badged": boolean
}
Поля
id

string

Идентификатор выбора.

displayName

string

Отображаемое имя выбора.

badged

boolean

Является ли выбор отмеченным значком.

ВыборСписокЗначение

Установка значения списка выбора путем выбора нескольких значений из раскрывающегося списка.

JSON-представление 
{
  "values": [
    {
      object (SelectionValue)
    }
  ]
}
Поля
values[]

object ( SelectionValue )

деятельность.список выбора.

Пользовательское значение

Установка значения пользователя путем выбора одного пользователя.

JSON-представление 
{
  "email": string
}
Поля
email

string

Электронная почта пользователя.

Усерлиствалуе

Установка значения списка пользователей путем выбора нескольких пользователей.

JSON-представление 
{
  "values": [
    {
      object (UserValue)
    }
  ]
}
Поля
values[]

object ( UserValue )

деятельность.список пользователей.

Дата

Представляет полную или частичную календарную дату, например день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата указана по григорианскому календарю. Это может представлять собой одно из следующих действий:

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Связанные типы:

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год даты. Должно быть от 1 до 9999 или 0, чтобы указать дату без года.

month

integer

Месяц года. Должно быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должно быть от 1 до 31 и действительно для года и месяца, или 0, чтобы указать год отдельно или год и месяц, если день не имеет значения.

Причина

Причина применения метки/поля.

JSON-представление 
{
  "reasonType": string
}
Поля
reasonType

string

Тип причины.