Получение статистики по пользователям (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: |
Query parameters
|
Name |
Description |
|
end_date |
Type: string<date> Дата, по которую нужно получить данные, включительно. Формат: Example: |
|
start_date |
Type: string<date> Дата, с которой нужно получить данные, включительно. Формат: Example: |
|
format |
Type: string Формат выгрузки данных. По умолчанию Const: Example: |
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: |
|
error |
Type: string Код ошибки Example: |
|
message |
Type: string Сообщение об ошибке. Example: |
|
details |
Type: objectДополнительные детали ошибки Example
|
403 Forbidden
Доступ к ресурсу запрещен. У пользователя или приложения недостаточно прав.
Body
application/json
{
"error": "forbidden",
"description": "Forbidden",
"message": "Forbidden",
"details": {}
}
|
Name |
Description |
|
description |
Type: string Техническое описание ошибки. Example: |
|
error |
Type: string Код ошибки Example: |
|
message |
Type: string Сообщение об ошибке. Example: |
|
details |
Type: objectДополнительные детали ошибки Example
|
Если выгрузка неполная, к имени файла добавляется префикс partial_. Например: partial_users_statistics_123456_2026-04-17_2026-04-17.csv.