検索

【API】 セッション/ セッション グループの作成

  • 更新

Learn365では、Learn365 管理センター、または Learn365 API を通じて、コースのセッションとセッション グループを作成することができます。

ここでは、API を通じてセッションまたはセッション グループを作成する方法を説明します。

注記：

セッションとセッション グループは、集合トレーニング コースにのみ適用できます。

作成するには以下が必要です。

  • セッションまたはセッション グループを作成するには、セッションまたはセッショングループに関連するコースのIDが必要です。コースID の取得については、こちらをご参照ください。
  • 既存のセッショングループの一部として新しいセッションを作成する場合は、そのセッショングループの ID が必要です。セッショングループ ID の取得については、こちらをご参照ください。

セッション / セッション グループを作成する

Learn365 API を通じたセッションまたはセッショングループの作成は、以下の手順に沿って行います。

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

2．Course セクションに移動し、POST /odata/v2/Courses({id})/CourseSessions Adds new Course Session or Group of Sessions to the Course を選択し、右上の「Try it out」をクリックします。

Create sessions via API-1.png

 

3．パラメータを入力します。

  • id＊：「Course Id」フィールドに、コース ID を入力します。
  • courseSession＊ ：「Edit Value」フィールドで、以下を入力します。
    • "Title": "string"：「string」を新しいセッションまたはセッショングループの名前に置き換えます。128文字以内で指定します。
    • "GroupId": "guid"：セッションをセッショングループの一部にする場合は、「guid」を該当するセッション グループ ID に置き換えます。 セッション グループを作成する場合、このパラメータは必要ありません。
    • "StartDate": "2024-10-22T23:54:00.0000000+00:00"： セッションの開始日を入力します。既定で現在の日付と時刻が予め設定されています。任意の日時に書き換えます。セッション グループの場合、このパラメータは必要ありません。
    • "EndDate": "2024-10-22T23:54:00.0000000+00:00"：セッションの終了日を入力します。既定で現在の日付と時刻が予め設定されています。任意の日時に書き換えます。セッション グループを作成する場合、このパラメータは必要ありません。
    • "TimeZone": "string"：「string」をセッション開始日/終了日のタイムゾーンに置き換えます。「UTC」などの文字列で入力します。セッショングループを作成する場合、このパラメータは必要ありません。
    • "IsGroup": "boolean"：セッショングループを作成する場合、「boolean」を「true」に置き換えます。セッションを作成する場合、このパラメータは必要ありません。

Microsoft Teams でオンラインセッションを作成する場合は、以下のパラメータを入力します。

  • "IsTeamsOnlineMeeting": "boolean"：「boolean」を "true" に置き換えます。
  • "MeetingUrl": "string"：「string」を Microsoft Teams 会議 URL に置き換えます。

これらのパラメータを入力するだけで、新しいセッションまたはセッション グループを作成できます。

その他の情報が必要な場合、該当するパラメータを入力します。

「$expand」フィールドと「$select」フィールドで レスポンス を絞り込むことができます。クエリ オプション パラメータの使用法については、こちらをご参照ください。

 

Create sessions via API-2.png

 

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

5．Responses ブロックで結果を確認します。

  • Code 2xx（201など）は、リクエストが正しく動作したことを示します。
  • Response body には、作成したセッションまたはセッション グループの詳細な情報が表示されます。
  • エラーの場合、Response body には、問題を説明するコードとメッセージ キーを持つエラー オブジェクトが含まれます。

Create sessions via API-3.png

 

Learn365 管理センター＞グローバル設定＞「監査証跡」で、作成したセッション/セッション グループに関する詳細な情報を確認することができます。

フィルター パネルの「活動」フィールドで「セッションが作成されました  /  セッション グループが作成されました」を選択し適用します。検索結果で該当するレコードを選択すると、詳細情報が表示されます。

Create sessions via API-4.png

 

Learn365 監査証跡については、こちらをご覧ください。