Получение статистики по пользователям

Возвращает статистику использования продуктов Яндекс 360 пользователями организации в формате JSON.

В отчете собраны данные за указанный период: от 1 дня до 3 месяцев. Данные за текущий день недоступны и появятся на следующий день.

Для выполнения запроса требуется право ya360_data:read_reports.

Request

GET

https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/users/statistics

Path parameters

Name

Description

org_id

Type: string

Идентификатор организации.

Example: 1234567

Query parameters

Name	Description
end_date	Type: string<date> Дата, по которую нужно получить данные, включительно. Формат: `YYYY-MM-DD`. Example: `2026-05-31`
start_date	Type: string<date> Дата, с которой нужно получить данные, включительно. Формат: `YYYY-MM-DD`. Example: `2026-05-01`
iteration_key	Type: string Ключ для получения следующей порции данных. Example: `next-page-key`
limit	Type: integer Максимальное количество записей в ответе.

Responses

200 OK

Статистика по пользователям организации получена.

Body

application/json

{
  "items": [
    {
      "date": "2026-05-01",
      "user_id": "1230000000000001",
      "nickname": "user",
      "account_type": "domain",
      "name": "Иван Иванов",
      "is_admin": false,
      "is_manager": true,
      "is_enabled": true,
      "mail_last_usage_date": "2026-05-01",
      "mail_sent_letters_count": 100,
      "mail_received_letters_count": 200,
      "mail_read_letters_count": 180,
      "mail_replied_letters_count": 50,
      "disk_last_usage_date": "2026-05-01",
      "disk_uploaded_files_count": 10,
      "disk_file_views_count": 50,
      "disk_downloaded_files_count": 20,
      "messenger_last_usage_date": "2026-05-01",
      "messenger_calls_count": 5,
      "messenger_chats_created_count": 2,
      "messenger_channels_created_count": 1,
      "telemost_last_usage_date": "2026-05-01",
      "telemost_conferences_count": 10,
      "telemost_conferences_created_count": 5,
      "telemost_conferences_total_time_minutes": 60,
      "telemost_live_streams_created_count": 0,
      "telemost_live_streams_count": 0,
      "telemost_conferences_average_time_minutes": 5
    }
  ],
  "iteration_key": "next-page-key"
}

Name

Description

items

Type: StatisticsItems

Список строк с данными по пользователям организации.

Example

[
  {
    "date": "2026-05-01",
    "user_id": "1230000000000001",
    "nickname": "user",
    "account_type": "domain",
    "name": "Иван Иванов",
    "is_admin": false,
    "is_manager": true,
    "is_enabled": true,
    "mail_last_usage_date": "2026-05-01",
    "mail_sent_letters_count": 100,
    "mail_received_letters_count": 200,
    "mail_read_letters_count": 180,
    "mail_replied_letters_count": 50,
    "disk_last_usage_date": "2026-05-01",
    "disk_uploaded_files_count": 10,
    "disk_file_views_count": 50,
    "disk_downloaded_files_count": 20,
    "messenger_last_usage_date": "2026-05-01",
    "messenger_calls_count": 5,
    "messenger_chats_created_count": 2,
    "messenger_channels_created_count": 1,
    "telemost_last_usage_date": "2026-05-01",
    "telemost_conferences_count": 10,
    "telemost_conferences_created_count": 5,
    "telemost_conferences_total_time_minutes": 60,
    "telemost_live_streams_created_count": 0,
    "telemost_live_streams_count": 0,
    "telemost_conferences_average_time_minutes": 5
  }
]

iteration_key

Type: string

Ключ для получения следующей порции данных.

Example: next-page-key

StatisticsItem

Статистика по пользователю за один день.

Name	Description
account_type	Type: string Тип аккаунта (`domain`/`portal`/`other`). Example: `domain`
date	Type: string<date> Дата, к которой относятся данные. Example: `2026-05-01`
disk_downloaded_files_count	Type: integer Количество скачиваний файлов с Диска.
disk_file_views_count	Type: integer Количество просмотров файлов на Диске.
disk_last_usage_date	Type: string<date> Дата последнего использования Диска. Example: `2026-05-01`
disk_uploaded_files_count	Type: integer Количество загруженных файлов на Диск.
is_admin	Type: boolean Является ли пользователь администратором.
is_enabled	Type: boolean Является ли пользователь активным (минимум 1 действие за последние 30 дней).
is_manager	Type: boolean Является ли пользователь менеджером.
mail_last_usage_date	Type: string<date> Дата последнего использования Почты. Example: `2026-05-01`
mail_read_letters_count	Type: integer Количество прочитанных писем.
mail_received_letters_count	Type: integer Количество полученных писем.
mail_replied_letters_count	Type: integer Количество писем с ответами.
mail_sent_letters_count	Type: integer Количество отправленных писем.
messenger_calls_count	Type: integer Количество звонков в Мессенджере.
messenger_channels_created_count	Type: integer Количество созданных каналов.
messenger_chats_created_count	Type: integer Количество созданных чатов.
messenger_last_usage_date	Type: string<date> Дата последнего использования Мессенджера. Example: `2026-05-01`
name	Type: string Имя пользователя. Example: `Иван Иванов`
nickname	Type: string Логин пользователя. Example: `user`
telemost_conferences_average_time_minutes	Type: integer Среднее время встреч в Телемосте (в минутах).
telemost_conferences_count	Type: integer Количество встреч в Телемосте.
telemost_conferences_created_count	Type: integer Количество созданных встреч в Телемосте.
telemost_conferences_total_time_minutes	Type: integer Общее время встреч в Телемосте (в минутах).
telemost_last_usage_date	Type: string<date> Дата последнего использования Телемоста. Example: `2026-05-01`
telemost_live_streams_count	Type: integer Количество прямых трансляций в Телемосте.
telemost_live_streams_created_count	Type: integer Количество созданных прямых трансляций в Телемосте.
user_id	Type: string Уникальный идентификатор (UID) пользователя. Example: `1230000000000001`

Example

{
  "date": "2026-05-01",
  "user_id": "1230000000000001",
  "nickname": "user",
  "account_type": "domain",
  "name": "Иван Иванов",
  "is_admin": false,
  "is_manager": true,
  "is_enabled": true,
  "mail_last_usage_date": "2026-05-01",
  "mail_sent_letters_count": 100,
  "mail_received_letters_count": 200,
  "mail_read_letters_count": 180,
  "mail_replied_letters_count": 50,
  "disk_last_usage_date": "2026-05-01",
  "disk_uploaded_files_count": 10,
  "disk_file_views_count": 50,
  "disk_downloaded_files_count": 20,
  "messenger_last_usage_date": "2026-05-01",
  "messenger_calls_count": 5,
  "messenger_chats_created_count": 2,
  "messenger_channels_created_count": 1,
  "telemost_last_usage_date": "2026-05-01",
  "telemost_conferences_count": 10,
  "telemost_conferences_created_count": 5,
  "telemost_conferences_total_time_minutes": 60,
  "telemost_live_streams_created_count": 0,
  "telemost_live_streams_count": 0,
  "telemost_conferences_average_time_minutes": 5
}

StatisticsItems

Список строк с данными по пользователям организации.

Type: StatisticsItem[]

Example

[
  {
    "date": "2026-05-01",
    "user_id": "1230000000000001",
    "nickname": "user",
    "account_type": "domain",
    "name": "Иван Иванов",
    "is_admin": false,
    "is_manager": true,
    "is_enabled": true,
    "mail_last_usage_date": "2026-05-01",
    "mail_sent_letters_count": 100,
    "mail_received_letters_count": 200,
    "mail_read_letters_count": 180,
    "mail_replied_letters_count": 50,
    "disk_last_usage_date": "2026-05-01",
    "disk_uploaded_files_count": 10,
    "disk_file_views_count": 50,
    "disk_downloaded_files_count": 20,
    "messenger_last_usage_date": "2026-05-01",
    "messenger_calls_count": 5,
    "messenger_chats_created_count": 2,
    "messenger_channels_created_count": 1,
    "telemost_last_usage_date": "2026-05-01",
    "telemost_conferences_count": 10,
    "telemost_conferences_created_count": 5,
    "telemost_conferences_total_time_minutes": 60,
    "telemost_live_streams_created_count": 0,
    "telemost_live_streams_count": 0,
    "telemost_conferences_average_time_minutes": 5
  }
]

400 Bad Request

Некорректный запрос.

Body

application/json

{
  "error": "validation_error",
  "description": "Validation error",
  "message": "Validation error",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Validation error

error

Type: string

Код ошибки

Example: validation_error

message

Type: string

Сообщение об ошибке.

Example: Validation error

details

Type: object

Дополнительные детали ошибки

Example

{}

403 Forbidden

Доступ к ресурсу запрещен. У пользователя или приложения недостаточно прав.

Body

application/json

{
  "error": "forbidden",
  "description": "Forbidden",
  "message": "Forbidden",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Forbidden

error

Type: string

Код ошибки

Example: forbidden

message

Type: string

Сообщение об ошибке.

Example: Forbidden

details

Type: object

Дополнительные детали ошибки

Example

{}

Была ли статья полезна?

Статистика по организации (CSV)

Статистика по пользователям (CSV)