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

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

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Комментарий: Восстановить из v. 6

Вы можете получить список пользователей с помощью метода getGamificationPointsgetUsers.

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

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

...

ПараметрТипОписание
credentials (обязательный)credentialsСмотрите описание объекта Credentials.
groupId (необязательный)stringЕсли этот параметр указан, будут выбраны пользователи, которые относятся к указанной группе.
departmentId (необязательный)stringЕсли этот параметр указан, будут выбраны пользователи указанного подразделения.

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

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

ПараметрТипОписание
usersUserProfile[]Массив с профилями пользователей. Объект UserProfile имеет такие же свойства, как метод getUserProfile.


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

ОшибкаОписание
Permission denied

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

Например, администратор подразделения не может получить список пользователей другого подразделения.

...

Блок кода
languagexml
<?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>
      <GetGamificationPointsRequest><GetUsersRequest>
        <credentials>
          <accountUrl>http://myaccount.ispringlearn.ru</accountUrl>
          <email>email@email.com</email>
          <password>password</password>
        </credentials>
    </GetUsersRequest>
    <<groupId>string</GetGamificationPointsRequest>groupId>
    <departmentId>string</departmentId>
  </SOAP-ENV:Body>
  </SOAP-ENV:Envelope>

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

Блок кода
languagexml
<?xml version="1.0" encoding="UTFutf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns1                 xmlns="http://ispringlearn.com/go/services/api/soap">
    <SOAP-ENV:Body>
    <GetUsersResult>
    <ns1:GetGamificationPointsResult>
  <userProfile>
          <ns1:user_points><userId>string</userId>
        ...
        <ns1:userId>2c180ffc-8841-11e9-b68a-0242c0a85016</ns1:userId></userProfile>
      <userProfile>
        <userId>string</userId>
  <ns1:points>421</ns1:points>
      ...
      </ns1:user_points>
    userProfile>
    </ns1:GetGamificationPointsResult>GetUsersResult>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

...