desire2learn - Desire2Learn 中的学生角色

Question

如何从 D2L 获取学生名单？我想得到学生的成绩，当我得到班级列表时，我得到了教师和学生的分数。

Answer 1

您可以使用/d2l/api/lp/{ver}/enrollments/orgUnits/{orgUnitId}/users/。这将获取一个由 orgUnitId 标识的课程中注册的所有用户的分页结果集。请注意，您可以使用roleId查询参数过滤结果集；如果您知道学生的角色 ID，则可以提供该 ID 以仅获取课程中具有学生角色的用户：

https://your.lms/d2l/api/lp/1.0/enrollments/orgUnits/6784/users/?roleId=78&{all_auth_qparms}

请注意，注册 API 调用需要调用用户上下文的某些角色权限。调用用户帐户需要“查看用户注册”权限，并在输出中显示已注册用户角色的“搜索 <角色名>”权限：

• 如果没有“查看用户注册”，您将根本没有任何查询注册的权限，并且您可能会收到 403（无权限或被禁止）。

• 如果您没有“搜索学生”或“搜索教师”权限（或任何您的本地角色），那么尽管您可以拨打注册电话，但您返回的注册用户列表将被过滤到只有您可以“搜索”的角色。

---

编辑. 我已经修复了这个答案；学生的默认角色 ID不是3（我认为这是课程设置的默认 OrgUnitID）。在我们的测试服务器上，默认的学生角色 ID 是“78”。

编辑 2。我添加了有关从注册调用中获取有用信息所需的权限的更多信息。