iSpring Port

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

Сравнение версий

Старая версия 1

changes.mady.by.user Irina Chumanova

Сохранено

по сравнению с

Новая версия 2

changes.mady.by.user Алина Задина

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Включить страницуL3:Лэйблы с указанием тарифаL3:Лэйблы с указанием тарифа

Метод: updateGroupMembers

Параметры запроса

ПараметрТипОписание
credentials (обязательный)credentialsСмотрите описание объекта Credentials.
groupId (обязательный)stringID группы, пользователи которой будут заменены.
userIds (обязательный)string []Массив из ID пользователей, которые будут добавлены в группу.


Подсказка

Переданные с помощью метода пользователи полностью заменяют состав группы. То есть, переданный и пустой параметр userIds удалит всех пользователей из группы. Если переданы ID двух пользователей, все ранее включенные в группу пользователи удалятся, а два новых пользователя добавятся. 

Важно:  если Администратор подразделения или Автор отправили список новых пользователей, которых надо добавить в группу, из существующих пользователей удалятся только те, которые входят в состав подразделений, которыми данный Администратор подразделения или Автор управляют, или их дочерних подразделений. 

Права пользователя для выполнения запроса

Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками, которые позволяют заменять участников группы.

Возвращаемые значения

После того, как запрос успешно обработан, система отправляет объект со следующими свойствами:

ПараметрТипОписание
successboolTrue, если пользователи в группе были успешно заменены.

Возможные ошибки

ТипОписание
Permission deniedУ пользователя недостаточно прав для замены пользователей в группе.
Wrong ParametersОдин из указанных параметров задан неверно.

Пример запроса

Блок кода
languagexml
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
      <UpdateGroupMembersRequest>
         <credentials>
          <accountUrl>https://myaccount.ispringlearn.ru</accountUrl>
          <email>email@email.com</email>
          <password>password</password>
         </credentials>
         <groupId>24d1abde-e063-11e9-b2cf-0a580af40a22</groupId>
         <userIds>
            <id>95385f4e-e031-11e9-a9da-0a580af40b0f</id>
	        <id>cfe9248a-deb4-11e9-979c-0a580af40764</id>
            <id>d030ff3a-deb4-11e9-b26a-0a580af40764</id>
            <id>d07ba5f8-deb4-11e9-a6de-0a580af40764</id>
         <userIds>
      </UpdateGroupMembersRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Пример ответа

Блок кода
languagexml
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://new.webservice.namespace">
  <SOAP-ENV:Body>
    <UpdateGroupMembersResult>
      <success>true</success>
    </UpdateGroupMembersResult>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>