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

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

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

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

Request

GET

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

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

Responses

200 OK

Статистика по организации получена.

Body

application/json

{
  "data": [
    {
      "date": "2026-05-01",
      "users_count": 100,
      "administrators_count": 5,
      "managers_count": 10,
      "active_users_count": 90,
      "blocked_users_count": 5,
      "domain_users_count": 80,
      "portal_users_count": 20,
      "guests_count": 5,
      "shared_contacts_count": 10,
      "shared_mailboxes_count": 2,
      "delegated_mailboxes_count": 3,
      "meeting_rooms_count": 4,
      "mail_active_users_count": 85,
      "mail_letters_count": 5000,
      "mail_sent_letters_count": 2500,
      "mail_received_letters_count": 2500,
      "mail_replied_letters_count": 1000,
      "mail_read_letters_count": 2000,
      "disk_active_users_count": 70,
      "disk_shared_disks_count": 15,
      "disk_shared_disks_total_space_gb": 1,
      "disk_shared_disks_limit_gb": 10,
      "disk_uploaded_files_count": 500,
      "disk_file_views_count": 2000,
      "disk_downloaded_files_count": 1500,
      "messenger_active_users_count": 60,
      "messenger_calls_count": 300,
      "messenger_chats_created_count": 50,
      "messenger_channels_created_count": 10,
      "telemost_active_users_count": 40,
      "telemost_conferences_count": 100,
      "telemost_conferences_created_count": 80,
      "telemost_conferences_total_time_minutes": 600,
      "telemost_conferences_average_time_minutes": 60,
      "telemost_conferences_average_participants": 5,
      "telemost_conferences_up_to_2_participants_count": 20,
      "telemost_conferences_up_to_5_participants_count": 50,
      "telemost_conferences_up_to_10_participants_count": 20,
      "telemost_conferences_up_to_50_participants_count": 8,
      "telemost_conferences_over_50_participants_count": 2,
      "telemost_live_streams_created_count": 5,
      "telemost_live_streams_count": 5,
      "telemost_live_streams_total_time_minutes": 300,
      "telemost_live_streams_average_time_minutes": 60,
      "telemost_live_streams_average_participants": 50
    }
  ]
}

Name

Description

data

Type: Data

Список строк с данными по организации.

Example

[
  {
    "date": "2026-05-01",
    "users_count": 100,
    "administrators_count": 5,
    "managers_count": 10,
    "active_users_count": 90,
    "blocked_users_count": 5,
    "domain_users_count": 80,
    "portal_users_count": 20,
    "guests_count": 5,
    "shared_contacts_count": 10,
    "shared_mailboxes_count": 2,
    "delegated_mailboxes_count": 3,
    "meeting_rooms_count": 4,
    "mail_active_users_count": 85,
    "mail_letters_count": 5000,
    "mail_sent_letters_count": 2500,
    "mail_received_letters_count": 2500,
    "mail_replied_letters_count": 1000,
    "mail_read_letters_count": 2000,
    "disk_active_users_count": 70,
    "disk_shared_disks_count": 15,
    "disk_shared_disks_total_space_gb": 1,
    "disk_shared_disks_limit_gb": 10,
    "disk_uploaded_files_count": 500,
    "disk_file_views_count": 2000,
    "disk_downloaded_files_count": 1500,
    "messenger_active_users_count": 60,
    "messenger_calls_count": 300,
    "messenger_chats_created_count": 50,
    "messenger_channels_created_count": 10,
    "telemost_active_users_count": 40,
    "telemost_conferences_count": 100,
    "telemost_conferences_created_count": 80,
    "telemost_conferences_total_time_minutes": 600,
    "telemost_conferences_average_time_minutes": 60,
    "telemost_conferences_average_participants": 5,
    "telemost_conferences_up_to_2_participants_count": 20,
    "telemost_conferences_up_to_5_participants_count": 50,
    "telemost_conferences_up_to_10_participants_count": 20,
    "telemost_conferences_up_to_50_participants_count": 8,
    "telemost_conferences_over_50_participants_count": 2,
    "telemost_live_streams_created_count": 5,
    "telemost_live_streams_count": 5,
    "telemost_live_streams_total_time_minutes": 300,
    "telemost_live_streams_average_time_minutes": 60,
    "telemost_live_streams_average_participants": 50
  }
]

DataItem

Статистика по организации за один день.

Name	Description
active_users_count	Type: integer Количество сотрудников с активными (не заблокированными) аккаунтами.
administrators_count	Type: integer Количество администраторов.
blocked_users_count	Type: integer Количество заблокированных сотрудников.
date	Type: string<date> Дата, к которой относятся данные. Example: `2026-05-01`
delegated_mailboxes_count	Type: integer Количество делегированных почтовых ящиков.
disk_active_users_count	Type: integer Количество активных пользователей Диска (минимум 1 действие за последние 30 дней).
disk_downloaded_files_count	Type: integer Количество скачиваний файлов с Диска.
disk_file_views_count	Type: integer Количество просмотров файлов на Диске.
disk_shared_disks_count	Type: integer Количество общих дисков.
disk_shared_disks_limit_gb	Type: integer Объем памяти оплаченных общих дисков (в гигабайтах).
disk_shared_disks_total_space_gb	Type: integer Объем памяти созданных общих дисков (в гигабайтах).
disk_uploaded_files_count	Type: integer Количество загруженных файлов на Диск.
domain_users_count	Type: integer Количество сотрудников с доменными аккаунтами.
guests_count	Type: integer Количество гостей.
mail_active_users_count	Type: integer Количество активных пользователей Почты (минимум 1 действие за последние 30 дней).
mail_letters_count	Type: integer Общее количество писем.
mail_read_letters_count	Type: integer Количество прочитанных писем.
mail_received_letters_count	Type: integer Количество полученных писем.
mail_replied_letters_count	Type: integer Количество писем с ответами.
mail_sent_letters_count	Type: integer Количество отправленных писем.
managers_count	Type: integer Количество менеджеров.
meeting_rooms_count	Type: integer Количество переговорных комнат.
messenger_active_users_count	Type: integer Количество активных пользователей Мессенджера (минимум 1 действие за последние 30 дней).
messenger_calls_count	Type: integer Количество звонков в Мессенджере.
messenger_channels_created_count	Type: integer Количество созданных каналов.
messenger_chats_created_count	Type: integer Количество созданных чатов.
portal_users_count	Type: integer Количество сотрудников с портальными аккаунтами.
shared_contacts_count	Type: integer Количество внешних контактов.
shared_mailboxes_count	Type: integer Количество общих ящиков.
telemost_active_users_count	Type: integer Количество активных пользователей Телемоста (минимум 1 действие за последние 30 дней).
telemost_conferences_average_participants	Type: integer Среднее количество участников встреч в Телемосте.
telemost_conferences_average_time_minutes	Type: integer Среднее время встречи в Телемосте (в минутах).
telemost_conferences_count	Type: integer Количество встреч в Телемосте.
telemost_conferences_created_count	Type: integer Количество созданных встреч в Телемосте.
telemost_conferences_over_50_participants_count	Type: integer Количество встреч с более чем 50 участниками.
telemost_conferences_total_time_minutes	Type: integer Общее время встреч в Телемосте (в минутах).
telemost_conferences_up_to_10_participants_count	Type: integer Количество встреч до 10 участников.
telemost_conferences_up_to_2_participants_count	Type: integer Количество встреч до 2 участников.
telemost_conferences_up_to_5_participants_count	Type: integer Количество встреч до 5 участников.
telemost_conferences_up_to_50_participants_count	Type: integer Количество встреч до 50 участников.
telemost_live_streams_average_participants	Type: integer Среднее количество зрителей прямых трансляций в Телемосте.
telemost_live_streams_average_time_minutes	Type: integer Среднее время прямой трансляции в Телемосте (в минутах).
telemost_live_streams_count	Type: integer Количество прямых трансляций в Телемосте.
telemost_live_streams_created_count	Type: integer Количество созданных прямых трансляций в Телемосте.
telemost_live_streams_total_time_minutes	Type: integer Общее время прямых трансляций в Телемосте (в минутах).
users_count	Type: integer Общее количество сотрудников.

Example

{
  "date": "2026-05-01",
  "users_count": 100,
  "administrators_count": 5,
  "managers_count": 10,
  "active_users_count": 90,
  "blocked_users_count": 5,
  "domain_users_count": 80,
  "portal_users_count": 20,
  "guests_count": 5,
  "shared_contacts_count": 10,
  "shared_mailboxes_count": 2,
  "delegated_mailboxes_count": 3,
  "meeting_rooms_count": 4,
  "mail_active_users_count": 85,
  "mail_letters_count": 5000,
  "mail_sent_letters_count": 2500,
  "mail_received_letters_count": 2500,
  "mail_replied_letters_count": 1000,
  "mail_read_letters_count": 2000,
  "disk_active_users_count": 70,
  "disk_shared_disks_count": 15,
  "disk_shared_disks_total_space_gb": 1,
  "disk_shared_disks_limit_gb": 10,
  "disk_uploaded_files_count": 500,
  "disk_file_views_count": 2000,
  "disk_downloaded_files_count": 1500,
  "messenger_active_users_count": 60,
  "messenger_calls_count": 300,
  "messenger_chats_created_count": 50,
  "messenger_channels_created_count": 10,
  "telemost_active_users_count": 40,
  "telemost_conferences_count": 100,
  "telemost_conferences_created_count": 80,
  "telemost_conferences_total_time_minutes": 600,
  "telemost_conferences_average_time_minutes": 60,
  "telemost_conferences_average_participants": 5,
  "telemost_conferences_up_to_2_participants_count": 20,
  "telemost_conferences_up_to_5_participants_count": 50,
  "telemost_conferences_up_to_10_participants_count": 20,
  "telemost_conferences_up_to_50_participants_count": 8,
  "telemost_conferences_over_50_participants_count": 2,
  "telemost_live_streams_created_count": 5,
  "telemost_live_streams_count": 5,
  "telemost_live_streams_total_time_minutes": 300,
  "telemost_live_streams_average_time_minutes": 60,
  "telemost_live_streams_average_participants": 50
}

Data

Список строк с данными по организации.

Type: DataItem[]

Example

[
  {
    "date": "2026-05-01",
    "users_count": 100,
    "administrators_count": 5,
    "managers_count": 10,
    "active_users_count": 90,
    "blocked_users_count": 5,
    "domain_users_count": 80,
    "portal_users_count": 20,
    "guests_count": 5,
    "shared_contacts_count": 10,
    "shared_mailboxes_count": 2,
    "delegated_mailboxes_count": 3,
    "meeting_rooms_count": 4,
    "mail_active_users_count": 85,
    "mail_letters_count": 5000,
    "mail_sent_letters_count": 2500,
    "mail_received_letters_count": 2500,
    "mail_replied_letters_count": 1000,
    "mail_read_letters_count": 2000,
    "disk_active_users_count": 70,
    "disk_shared_disks_count": 15,
    "disk_shared_disks_total_space_gb": 1,
    "disk_shared_disks_limit_gb": 10,
    "disk_uploaded_files_count": 500,
    "disk_file_views_count": 2000,
    "disk_downloaded_files_count": 1500,
    "messenger_active_users_count": 60,
    "messenger_calls_count": 300,
    "messenger_chats_created_count": 50,
    "messenger_channels_created_count": 10,
    "telemost_active_users_count": 40,
    "telemost_conferences_count": 100,
    "telemost_conferences_created_count": 80,
    "telemost_conferences_total_time_minutes": 600,
    "telemost_conferences_average_time_minutes": 60,
    "telemost_conferences_average_participants": 5,
    "telemost_conferences_up_to_2_participants_count": 20,
    "telemost_conferences_up_to_5_participants_count": 50,
    "telemost_conferences_up_to_10_participants_count": 20,
    "telemost_conferences_up_to_50_participants_count": 8,
    "telemost_conferences_over_50_participants_count": 2,
    "telemost_live_streams_created_count": 5,
    "telemost_live_streams_count": 5,
    "telemost_live_streams_total_time_minutes": 300,
    "telemost_live_streams_average_time_minutes": 60,
    "telemost_live_streams_average_participants": 50
  }
]

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

{}

Была ли статья полезна?

Обзор

Статистика по организации (CSV)