ДОСТУПНО В BUSINESS ПОДПИСКЕ
Метод: getCoursesTreeV2
С помощью метода вы можете получить дерево курсов и других элементов контента.
Если передать ID элементов, метод вернёт информацию для указанных элементов дерева.
Права пользователя для выполнения запроса
Пользователи с ролью Владелец аккаунта, Администратор аккаунта, Администратор подразделения, Автор курсов или роль с индивидуальными настройками, у которых есть доступ на редактирование материала.
Автор материала может добавить соавторов во вкладке Совместный доступ.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| credentials (обязательный) | object | Данные для авторизации |
| itemIds (необязательный) | array | ID элементов дерева, которые вы хотите получить |
Возвращаемые значения
| Параметр | Тип | Описание |
| item | array | Элемент дерева |
| itemId | string | ID элемента |
| title | string | Название элемента |
| type | string | Тип элемента |
| description | string | Описание элемента |
| addedDate | dateTime | Дата добавления элемента |
| viewUrl | string | Ссылка на просмотр элемента |
| parentId | string | ID родительского элемента |
| isShared | boolean | true, если элемент является общим, иначе — false |
Параметр type содержит тип элемента дерева:
- iSpringSuiteModule
- Course
- Page
- Folder
- Link
- SCORM
- LearningTrack
- PowerPointPresentation
- WordDocument
- PDFDocument
- ExcelSpreadsheet
- OnlineQuiz
- Quiz
- RolePlay
- Book
- Interaction
- Video
- Audio
- Assignment
- ExternalCourse
Возможные ошибки
| Ошибка | Описание |
| Permission denied | У пользователя недостаточно прав для выполнения запроса |
Пример запроса
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns="http://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<GetCoursesTreeV2Request>
<credentials>
<accountUrl>https://my.ispringlearn.ru</accountUrl>
<email>admin@example.com</email>
<password>password</password>
</credentials>
<itemIds>
<id>cdcc8b68-3c12-11f1-8f8c-ce3ca9be27b7</id>
<id>f14f33c0-00e3-11f0-a54a-6a1a5a293090</id>
</itemIds>
</GetCoursesTreeV2Request>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Пример ответа
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<ns1:GetCoursesTreeV2Result>
<ns1:item>
<ns1:itemId>cdcc8b68-3c12-11f1-8f8c-ce3ca9be27b7</ns1:itemId>
<ns1:title>Информационная безопасность</ns1:title>
<ns1:type>Course</ns1:type>
<ns1:description>Example course</ns1:description>
<ns1:addedDate>2026-08-01T10:00:00+00:00</ns1:addedDate>
<ns1:viewUrl>https://my.ispringlearn.ru/view/example-course</ns1:viewUrl>
<ns1:parentId>0</ns1:parentId>
<ns1:isShared>false</ns1:isShared>
</ns1:item>
<ns1:item>
<ns1:itemId>d8b95c1f-3c12-11f1-bbd0-9a42ef69602a</ns1:itemId>
<ns1:title>Как установить безопасный пароль</ns1:title>
<ns1:type>Page</ns1:type>
<ns1:description>Example page</ns1:description>
<ns1:addedDate>2026-08-01T10:05:00+00:00</ns1:addedDate>
<ns1:viewUrl>https://my.ispringlearn.ru/view/example-page</ns1:viewUrl>
<ns1:parentId>cdcc8b68-3c12-11f1-8f8c-ce3ca9be27b7</ns1:parentId>
<ns1:isShared>false</ns1:isShared>
</ns1:item>
</ns1:GetCoursesTreeV2Result>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>