Выгрузить статистику по пользователям (CSV)
Возвращает CSV-файл со статистикой использования продуктов Яндекс 360 пользователями организации.
В отчете собраны данные за указанный период (от 1 дня до 3 месяцев). Данных за текущий день нет — они станут доступны только завтра.
Максимальный размер файла — 408 666 строк. Чтобы получить больше данных, выгрузите статистику в формате JSON.
Примечание
Чтобы выполнить запрос, приложению требуется разрешение на чтение статистики ya360_data:read_reports. Убедитесь, что вы включили его при настройке OAuth-приложения.
Запрос
GET https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/users/statistics/export
Path-параметры
|
Имя параметра |
Тип |
Описание |
|
org_id * |
string |
Идентификатор организации. |
Query-параметры
|
Имя параметра |
Тип |
Описание |
|
start_date * |
string |
Дата, с которой нужно получить данные. Формат: |
|
end_date * |
string |
Дата, по которую нужно получить данные. Формат: |
|
format |
string |
Формат выгрузки данных. По умолчанию |
Заголовки
Authorization: OAuth <токен>
Пример
Пример запроса
curl \
-f \
--url 'https://disk-1.prestable.cloud-api.dsp.yandex.net/v1/directory/organizations/123456/users/statistics/export?start_date=2026-04-17&end_date=2026-04-17' \
-H "Authorization: OAuth <токен>" \
-O -J
Имя итогового файла — users_statistics_123456_2026-04-17_2026-04-17.csv.
Если данных больше лимита (408 666 строк), отчет скачается не полностью. В этом случае к названию добавится префикс partial_ — partial_users_statistics_123456_2026-04-17_2026-04-17.csv.
Ответ
Успешный ответ
Результатом корректного запроса является ответ с кодом 200 и телом в формате CSV.
200 OK — запрос выполнен успешно.
Содержимое файла:
CSV файл со статистикой по пользователям организации. Содержит следующие поля:
date— дата, к которой относятся данные;user_id— uid пользователя;nickname— 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— среднее время встреч в Телемосте (в минутах).
Неуспешный ответ
Ошибки могут быть со следующими HTTP-статусами:
400 Bad Request— параметры запроса не заданы или заданы неверно;401 Unauthorized— пользователь не авторизован;403 Forbidden— у пользователя или приложения нет прав на доступ к статистике;404 Not Found— запрашиваемая организация не найдена;500 Internal Server Error— ошибка произошла на стороне сервера.