Вы можете создать новую группу с помощью метода addGroup.
Роль пользователя для выполнения запроса: Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками, которые позволяют добавлять группы.
Параметры запроса
Параметр | Тип | Описание |
---|---|---|
credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
name (обязательный) | string | Название новой группы. |
userId (необязательный) | string | ID пользователя |
Возвращаемые значения
После того, как запрос был успешно обработан, система отправляет объект со следующими свойствами:
Параметр | Тип | Описание |
---|---|---|
groupId | string | ID добавленной группы. |
Возможные ошибки
Тип | Описание |
---|---|
Permission denied | У пользователя недостаточно прав для добавления групп. |
Wrong parameters | Не удалось обработать запрос, так как он не включает все нужные параметры или они заданы неверно. |
Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://ispringlearn.com/go/services/api/soap"> <soapenv:Header/> <soapenv:Body> <soap:AddGroupRequest> <soap:credentials> <soap:accountUrl>https://myaccount.ispringlearn.ru/</soap:accountUrl> <soap:email>owner</soap:email> <soap:password>12345Q</soap:password> </soap:credentials> <soap:name>NEW_GROUP</soap:name> <!--Optional:--> <soap:userIds> <soap:id>cfe9248a-deb4-11e9-979c-0a580af40764</soap:id> <soap:id>d030ff3a-deb4-11e9-b26a-0a580af40764</soap:id> <soap:id>d07ba5f8-deb4-11e9-a6de-0a580af40764</soap:id> </soap:userIds> </soap:AddGroupRequest> </soapenv:Body> </soapenv:Envelope>
Пример ответа
<?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> <AddGroupResult> <groupId>string</groupId> </AddGroupResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope>