Skip to main content
Объект group описывает учебную или продуктовую группу: участников, правила доступа, расписание и настройки коммуникаций.
Списочный метод group/list/raw возвращает компактную проекцию (groupId, name, courseId, courseName). Ниже описана полная публичная структура объекта group.

Поля group

Основные

id
integer
required
ID группы.
uuid
string
required
UUID группы.
name
string
required
Название группы.
space
enum
required
Пространство группы: Education.
order
integer | null
Порядок сортировки.
maxMembers
integer | null
Максимальное число участников.

Ограничения и настройки

communication
object
required
Настройки коммуникаций (Telegram-канал, групповой чат, режимы подключения).
accessLimitation
object
required
Ограничения доступа: тип старта, общая дата старта, длительность и т.п.
scheduleLimitation
object
required
Ограничения по расписанию (окна доступа по дням/часам, ограничения по датам).
contentLimitation
object
required
Ограничения по контенту (правила доступа к урокам, зависимости от заданий).

Telegram

isTgConnected
boolean | null
Есть ли активная связь группы с Telegram.
tgConnectionMode
enum | null
Режим подключения Telegram: Disconnected, Connected, Required.

Системные поля аудита

createdAt
string
required
Дата создания (ISO 8601).
updatedAt
string
required
Дата обновления (ISO 8601).
archivedAt
string | null
Дата архивации или null.

Пример объекта group

{
  "id": 101,
  "uuid": "8b8b2b0e-6a27-4c3c-b5a5-9f4f0e3f1c01",
  "name": "Группа 7А — Математика",
  "space": "Education",
  "order": 10,
  "maxMembers": 30,
  "isTgConnected": false,
  "tgConnectionMode": "Disconnected",
  "createdAt": "2025-01-10T09:00:00Z",
  "updatedAt": "2025-01-15T12:30:00Z",
  "archivedAt": null,
  "communication": {
    "tgChannelId": null,
    "tgGroupChatId": null
  },
  "accessLimitation": {
    "active": true,
    "startPointType": "CommonDate"
  },
  "scheduleLimitation": {
    "active": false
  },
  "contentLimitation": {
    "active": false
  }
}

Связанные объекты

  • Участники группы — объекты groupMember.