Выгрузить статистику по организации (CSV)
Возвращает CSV-файл с агрегированной статистикой использования продуктов Яндекс 360 по всей организации.
В отчете собраны общие данные за указанный период (от 1 дня до 3 месяцев). Данных за текущий день нет — они станут доступны только завтра.
Примечание
Чтобы выполнить запрос, приложению требуется разрешение на чтение статистики ya360_data:read_reports. Убедитесь, что вы включили его при настройке OAuth-приложения.
Запрос
GET https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/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/statistics/export?start_date=2026-04-17&end_date=2026-04-17' \
-H "Authorization: OAuth <токен>" \
-O -J
Имя итогового файла — statistics_123456_2026-04-17_2026-04-17.csv.
Ответ
Успешный ответ
Результатом корректного запроса является ответ с кодом 200 и телом в формате CSV.
200 OK — запрос выполнен успешно.
Содержимое файла:
CSV файл со статистикой по организации. Содержит следующие поля:
date— дата, к которой относятся данные;users_count— общее количество сотрудников;administrators_count— количество администраторов;managers_count— количество менеджеров;active_users_count— количество активных сотрудников (минимум 1 действие в продуктах за последние 30 дней);blocked_users_count— количество заблокированных сотрудников;domain_users_count— количество сотрудников с доменными аккаунтами;portal_users_count— количество сотрудников с портальными аккаунтами;guests_count— количество гостей;shared_contacts_count— количество внешних контактов;shared_mailboxes_count— количество общих ящиков;delegated_mailboxes_count— количество делегированных почтовых ящиков;meeting_rooms_count— количество переговорных комнат;mail_active_users_count— количество активных пользователей Почты (минимум 1 действие за последние 30 дней);mail_letters_count— общее количество писем;mail_sent_letters_count— количество отправленных писем;mail_received_letters_count— количество полученных писем;mail_replied_letters_count— количество писем с ответами;mail_read_letters_count— количество прочитанных писем;disk_active_users_count— количество активных пользователей Диска (минимум 1 действие за последние 30 дней);disk_shared_disks_count— количество общих дисков;disk_shared_disks_total_space_gb— объем памяти созданных общих дисков (в гигабайтах);disk_shared_disks_limit_gb— объем памяти оплаченных общих дисков (в гигабайтах);disk_uploaded_files_count— количество загруженных файлов на диск;disk_file_views_count— количество просмотров файлов на диске;disk_downloaded_files_count— количество скачиваний файлов с диска;messenger_active_users_count— количество активных пользователей Мессенджера (минимум 1 действие за последние 30 дней);messenger_calls_count— количество звонков в Мессенджере;messenger_chats_created_count— количество созданных чатов;messenger_channels_created_count— количество созданных каналов;telemost_active_users_count— количество активных пользователей Телемоста (минимум 1 действие за последние 30 дней);telemost_conferences_count— количество встреч в Телемосте;telemost_conferences_created_count— количество созданных встреч в Телемосте;telemost_conferences_total_time_minutes— общее время встреч в Телемосте (в минутах);telemost_conferences_average_time_minutes— среднее время встреч в Телемосте (в минутах);telemost_conferences_average_participants— среднее количество участников встреч в Телемосте;telemost_conferences_up_to_2_participants_count— количество встреч до 2 участников;telemost_conferences_up_to_5_participants_count— количество встреч до 5 участников;telemost_conferences_up_to_10_participants_count— количество встреч до 10 участников;telemost_conferences_up_to_50_participants_count— количество встреч до 50 участников;telemost_conferences_over_50_participants_count— количество встреч с более чем 50 участниками;telemost_live_streams_created_count— количество созданных прямых трансляций в Телемосте;telemost_live_streams_count— количество прямых трансляций в Телемосте;telemost_live_streams_total_time_minutes— общее время прямых трансляций в Телемосте (в минутах);telemost_live_streams_average_time_minutes— среднее время прямой трансляции в Телемосте (в минутах);telemost_live_streams_average_participants— среднее количество зрителей прямых трансляций в Телемосте.
Неуспешный ответ
Ошибки могут быть со следующими HTTP-статусами:
400 Bad Request— параметры запроса не заданы или заданы неверно;401 Unauthorized— пользователь не авторизован;403 Forbidden— у пользователя или приложения нет прав на доступ к статистике;404 Not Found— запрашиваемая организация не найдена;500 Internal Server Error— ошибка произошла на стороне сервера.