【API】 コースカタログにユーザーを追加する

  • 更新

Learn365 では、Learn365 管理センターまたは Learn365 API を通じて、コース カタログにユーザーを追加(招待)することができます。

ここでは、Learn365 API を通じた、コースカタログへのユーザーの追加(招待)について説明します。

 

Learn365 API を通じたコースカタログへのユーザーの追加(招待)は、以下の手順に沿って行います。

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

2.CourseCatalogs セクションを移動し、POST /odata/v2/CourseCatalogs({id})/Users Add user to the Course Catalog を選択し、右上の「Try it out」をクリックします。

 

Add users to a course catalog via API1.png

 

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

  • idユーザーを追加(招待)する コースカタログ ID を入力します。 このパラメータは入力必須です。
  • user:「Edit Value」フィールドで、以下の必須パラメータを入力します。この情報は Microsoft Entra ID(Azure Active Directory) 管理センターで確認できます。

    {
    "LoginName": "string",
    (string を Microsoft Entra ID のユーザプリンシパル名に置き換えます。)
    "DirectoryObjectId": "string",
    (string をオブジェクト ID に置き換えます。このパラメータは、組織の Microsoft Entra ID に同じログイン名を持つユーザーが存在する場合に必要です。
    たとえば、ユーザーが削除され、再度作成された場合や、同じ姓名のユーザーが存在する場合など。
    }

その他のパラメータは任意(オプション)です。

 

入力例:

{
"LoginName": "ChrisEvance@Learn365preview.onmicrosoft.com",
"DirectoryObjectId": "e46480dd-39ec-4da4-ad23-153fb0430d2c"
}

 

Add users to a course catalog via API2.png

 

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

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

これにより、ユーザーにはカタログのすべてのコース、トレーニングプランのホームページを表示するためのアクセス許可が付与され、カタログ内を移動する際に SharePoint によるアクセス拒否を回避できます。

 

Add users to a course catalog via API3.png