Добавление группы

Вы можете создать новую группу с помощью метода 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>

Дерево страниц