D2L から学生のリストを取得するにはどうすればよいですか? 学生の成績を取得したいのですが、クラスリストを取得すると、インストラクターと学生のマークの両方が取得されます。
1 に答える
/d2l/api/lp/{ver}/enrollments/orgUnits/{orgUnitId}/users/を使用できます。これにより、orgUnitId で識別されるコース オファリングに登録されているすべてのユーザーのページ化された結果セットが取得されます。roleId
query パラメータを使用して結果セットをフィルタリングできることに注意してください。学生の役割 ID がわかっている場合は、それを指定して、学生の役割を持つコース内のユーザーだけを取得できます。
https://your.lms/d2l/api/lp/1.0/enrollments/orgUnits/6784/users/?roleId=78&{all_auth_qparms}
登録 API 呼び出しには、呼び出し元のユーザー コンテキストの特定のロール アクセス許可が必要であることに注意してください。呼び出し元のユーザー アカウントには、「ユーザー登録の表示」権限が必要であり、出力に表示される登録済みユーザー ロールの「< ロール名 > の検索」権限が必要です。
「View User Enrollments」がないと、登録を照会する権限がまったくなく、おそらく 403 が返されます (権限がないか、禁止されています)。
「学生の検索」権限または「インストラクターの検索」権限 (またはローカル ロールが何であれ) を持っていない場合、登録呼び出しを行うことはできますが、返される登録済みユーザーのリストは次のようにフィルタリングされます。 「検索」できるロールのみ。
編集します。この回答を修正しました。学生のデフォルトのロール IDは 3 ではありませんでした (これは、コース オファリングのデフォルトの OrgUnitID だと思います)。テスト サーバーでは、デフォルトの学生ロール ID は「78」です。
2を編集します。登録呼び出しから有用な情報を取得するために必要なアクセス許可に関する情報を追加しました。