API によるユーザーのアクティブな登録 ID の取得

  • 更新

ここでは、Learn365 API を通じた、Learn365 におけるユーザーのアクティブな登録 ID の取得について説明します。

 

API を通じたユーザーのアクティブな登録 IDの取得は、以下の手順に沿って行います。

1. https://api.365.systems/  にアクセスし、APIキーで認証します。

2.Users セクションに移動し、GET /odata/v2/Enrollments  Returns the list of current user's active Enrollments を選択し、右上の「Try it out」を選択します。

 

ID of user's active enrollments1.png

 

クエリ オプション パラメータを設定して レスポンス データを絞り込むことができます。

  • テナントで有効なすべてのユーザーの登録データを取得したい場合は、フィールドは空のままにします。
  • レスポンス データを絞り込みたい場合は、クエリフィールドにクエリパラメータを指定します。レスポンス データには、絞り込まれたデータのみが含まれます。
  • レスポンスに登録されているすべてのセッションの ID とタイトルを含めるには、$expand フィールドに「AllCourseSessions」と入力します。

例:

特定のコースのアクティブな登録の情報を取得する場合:

$filter フィールドに「CourseId eq ID」 と入力します(IDは関連するコースのID)。コース IDの取得については、こちらを参照してください。
この場合、レスポンスにはこのコースのみに関連するすべての受講者のアクティブな登録が含まれます。

このコースの特定の受講者のアクティブな登録 ID を取得したい場合、ユーザーIDを取得し、レスポンス データをさらに絞り込みます。

 

ID of user's active enrollments2.png

 

3.「Execute」を選択してリクエストを実行します。

4.Responses ブロックで結果を確認します。

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • クエリ オプション パラメータが設定されていない場合、Response body には登録 ID を含むテナント上のすべてのユーザーのすべてのアクティブな登録に関するデータが表示されます。
  • Id パラメータの横の値は、各コースの各ユーザのユニークな登録 IDを示しています。
  • クエリ オプション パラメータが設定された場合、Response body には関連するデータのみが表示されます。
  • Ctrl+Fで特定の ID を検索することができます。
  • Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。

ID of user's active enrollments3.png