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

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

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

Максимальный размер файла: 408 666 строк. Если данных больше, используйте получение статистики по пользователям в формате JSON.

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

Request

GET

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

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

format

Type: string

Формат выгрузки данных.

По умолчанию csv.

Const: csv

Example: csv

Responses

200 OK

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

Body

text/csv

Type: string

Format: binary

Description: CSV-файл со статистикой по пользователям организации содержит следующие поля:

  • date — дата, к которой относятся данные;
  • user_id — UID пользователя;
  • nickname — логин пользователя;
  • account_type — тип аккаунта: domain, portal или other;
  • name — имя пользователя;
  • is_admin — признак администратора;
  • is_manager — признак менеджера;
  • is_enabled — признак активности пользователя: минимум 1 действие за последние 30 дней;
  • mail_last_usage_date — дата последнего использования Почты;
  • mail_sent_letters_count — количество отправленных писем;
  • mail_received_letters_count — количество полученных писем;
  • mail_read_letters_count — количество прочитанных писем;
  • mail_replied_letters_count — количество писем с ответами;
  • disk_last_usage_date — дата последнего использования Диска;
  • disk_uploaded_files_count — количество загруженных файлов на Диск;
  • disk_file_views_count — количество просмотров файлов на Диске;
  • disk_downloaded_files_count — количество скачиваний файлов с Диска;
  • messenger_last_usage_date — дата последнего использования Мессенджера;
  • messenger_calls_count — количество звонков в Мессенджере;
  • messenger_chats_created_count — количество созданных чатов;
  • messenger_channels_created_count — количество созданных каналов;
  • telemost_last_usage_date — дата последнего использования Телемоста;
  • telemost_conferences_count — количество встреч в Телемосте;
  • telemost_conferences_created_count — количество созданных встреч в Телемосте;
  • telemost_conferences_total_time_minutes — общее время встреч в Телемосте в минутах;
  • telemost_live_streams_created_count — количество созданных прямых трансляций в Телемосте;
  • telemost_live_streams_count — количество прямых трансляций в Телемосте;
  • telemost_conferences_average_time_minutes — среднее время встреч в Телемосте в минутах;

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
{}

Если выгрузка неполная, к имени файла добавляется префикс partial_. Например: partial_users_statistics_123456_2026-04-17_2026-04-17.csv.