Получение статистики по организации (CSV)

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

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

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

Request

GET

https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/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 — дата, к которой относятся данные;
  • users_count — общее количество сотрудников;
  • administrators_count — количество администраторов;
  • managers_count — количество менеджеров;
  • active_users_count — количество сотрудников с активными (не заблокированными) аккаунтами;
  • 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 — среднее количество зрителей прямых трансляций в Телемосте;

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