Method: activities.list

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

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 в 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 дней.

Для запросов в Gmail необходимо указать startTime и endTime , при этом разница между ними не должна превышать 30 дней.

eventName

string

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

filters

string

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

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

В приведенных ниже примерах действий в Google Диске возвращаемый список состоит из всех событий 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 (startTime) должно быть раньше времени endTime (endTime, если указано) и текущего времени запроса, иначе API вернет ошибку.

Для запросов в Gmail необходимо указать startTime и endTime , при этом разница между ними не должна превышать 30 дней.

groupIdFilter

string

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

resourceDetailsFilter

string

Необязательный параметр. Строка запроса resourceDetailsFilter представляет собой список, разделенный оператором И, состоящий из полей сведений о ресурсе, обработанных реляционными операторами.

Фильтры сведений о ресурсе имеют вид {resourceDetails.field1}{relational operator}{field1 value} AND {resourceDetails.field2}{relational operator}{field2 value}...

Все внутренние поля обрабатываются с помощью оператора . , как показано в следующем примере:

resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id =
"appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id =
"fieldValueId"

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

  • = —'равно'.
  • != —'не равно'.
  • : —'существует'. Используется для фильтрации по повторяющимся полям.

Для типов FieldValue , которые повторяются, используется оператор exists для фильтрации.
Следующие типы FieldValue повторяются:

Например, в следующем фильтре поле SelectionListValue является повторяющимся. Фильтр проверяет, содержит ли SelectionListValue selection_id :

resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id =
"appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id =
"fieldValueId" AND resourceDetails.appliedLabels.fieldValue.type =
"SELECTION_LIST_VALUE" AND
resourceDetails.appliedLabels.fieldValue.selectionListValue.id: "id"

Использование

GET...&resourceDetailsFilter=resourceDetails.id = "resourceId" AND
resourceDetails.appliedLabels.id = "appliedLabelId"
GET...&resourceDetailsFilter=resourceDetails.id=%22resourceId%22%20AND%20resourceDetails.appliedLabels.id=%22appliedLabelId%22

Обратите внимание на следующее :

  • Перед отправкой запроса необходимо закодировать строку запроса в формате URL.

  • API поддерживает максимум 5 полей, разделенных оператором И.

  • При фильтрации по более глубоким уровням (например, AppliedLabel , FieldValue ) в фильтр необходимо включить идентификаторы всех предшествующих уровней в иерархии. Например: для фильтрации по FieldValue необходимо наличие идентификатора AppliedLabel и идентификатора resourceDetails.
    Пример запроса :

    resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id = "appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id = "fieldValueId"

  • Для фильтрации по внутренним типам FieldValue , таким как longTextValue и textValue необходимо наличие свойства resourceDetails.appliedLabels.fieldValue.type .

  • Поддерживается только фильтрация по одному идентификатору AppliedLabel и одному идентификатору FieldValue .

networkInfoFilter

string

Необязательный параметр. Используется для фильтрации по полю regionCode присутствующему в сообщении NetworkInfo .

Использование

GET...&networkInfoFilter=regionCode="IN"
GET...&networkInfoFilter=regionCode=%22IN%22
statusFilter

string

Необязательный параметр. Используется для фильтрации по полю statusCode присутствующему в сообщении Status .

Использование

GET...&statusFilter=statusCode="200"
GET...&statusFilter=statusCode=%22200%22
applicationInfoFilter

string

Необязательный параметр. Используется для фильтрации по полю oAuthClientId присутствующему в сообщении ApplicationInfo .

Использование

GET...&applicationInfoFilter=oAuthClientId="clientId"
GET...&applicationInfoFilter=oAuthClientId=%22clientId%22

Текст запроса

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

Ответный текст

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 Drive предоставляют информацию о различных событиях, связанных с использованием Google Drive . Отчет об активности Drive доступен только для клиентов Google Workspace Business и Enterprise.

gcp В отчетах об активности приложения Google Cloud Platform содержится информация о различных событиях, связанных с активностью в GCP .
gmail Отчеты об активности приложения Gmail предоставляют информацию о различных событиях, связанных с работой Gmail .
gplus В отчетах об активности приложения Google+ содержится информация о различных событиях, связанных с активностью в Google+ .
groups

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

groups_enterprise

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

jamboard Отчеты об активности в Jamboard содержат информацию о различных событиях, связанных с активностью в Jamboard .
login

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

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

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

saml

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

token

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

user_accounts

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

context_aware_access

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

chrome

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

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

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

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

Активность

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
      ],
      "status": {
        object (Status)
      }
    }
  ],
  "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
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ]
}
Поля
kind

string

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

etag

string

ETag записи.

ownerDomain

string

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

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

activities.list of messageValue objects.

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

object ( NestedParameter )

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

events[].resourceIds[]

string

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

events[].status

object ( Status )

Статус события. Примечание: Не все события имеют статус.

id

object

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

id.time

string

Время возникновения активности. Указано в секундах в формате UNIX epoch.

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

Выполняло ли приложение действия, имитирующие действия пользователя.

networkInfo

object ( NetworkInfo )

Сетевая информация о пользователе, выполняющем действие.

resourceDetails[]

object ( ResourceDetails )

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

NetworkInfo

Сетевая информация о пользователе, выполняющем действие.

JSON-представление 
{
  "ipAsn": [
    integer
  ],
  "regionCode": string,
  "subdivisionCode": string
}
Поля
ipAsn[]

integer

IP-адрес пользователя, выполняющего действие.

regionCode

string

Код региона ISO 3166-1 alpha-2 пользователя, выполняющего действие.

subdivisionCode

string

Код региона ISO 3166-2 (штаты и провинции) для стран, в которых находится пользователь, выполняющий действие.

ResourceDetails

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

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

string

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

title

string

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

type

string

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

appliedLabels[]

object ( AppliedLabel )

activities.list of labels applied to the resource

relation

string

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

AppliedLabel

Подробная информация о маркировке, нанесенной на ресурс.

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

string

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

title

string

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

fieldValues[]

object ( FieldValue )

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

reason

object ( Reason )

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

FieldValue

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

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

Если поле не задано, это будет иметь значение true.

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 )

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

TextListValue

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

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

string

activities.list of text values.

SelectionValue

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

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

string

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

displayName

string

Отобразить название выбранного элемента.

badged

boolean

Есть ли у данного товара маркировка?

SelectionListValue

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

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

object ( SelectionValue )

activities.list of selections.

UserValue

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

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

string

Адрес электронной почты пользователя.

UserListValue

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

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

object ( UserValue )

activities.list of users.

Дата

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

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

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

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

Тип причины.