検索

【API】 コースカタログ名と URL の変更

  • 更新

コースカタログのタイトルと URL は、Learn365 API を通じて変更することができます。

たとえば、テスト環境でトレーニングを含むコースカタログを作成し、それを本番環境に移行するような場合に利用できます。

Learn365 のコースカタログ名と URL の変更は、SharePoint  と Learn365 API で行う必要があります。

ここでは、その手順について説明します。

 

Step1： SharePoint でサイト名と URL を変更する

この操作に必要なロール：Microsoft 365 グローバル管理者、または SharePoint 管理者

こちら Microsoft のガイド の手順にしたがって、SharePoint で該当するコースカタログのサイトの名前と URL を変更します。

 

Step2：Learn365 API でカタログ名と URL を変更する

Learn365 API を通じてコースカタログ名とURLを変更するには、該当するコースカタログのID が必要です。

コース カタログ ID の取得については、こちらをご参照ください。

 

Learn365 API を通じたカタログ名とURLの変更は、以下の手順に沿って行います。

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

2．CoursesCatalogs セクションに移動し、PATCH  ​/odata/v2/CourseCatalogs({Id}) Update individual fields of existing Course Catalog エンドポイントを選択し、右上の「Try it out」をクリックします。

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

  • Id＊：「key: Id」フィールドに、コースカタログ ID を入力します。
  • CoursesCatalogs＊：「Edit Value」フィールドに、以下を入力します。
    • "Owners": []：この行はすべて削除します。
    • "Title": "string"：「string」 を新しい名前に置き換えます。（Step1 で設定した新しいサイト名）
    • "Url": "string"：「string」 を新しい URL に置き換えます。（Step1 で設定した新しい URL ）

更新しないプロパティはその行すべてを削除します。（たとえば、カタログ名のみ変更する場合は、"Url": "string"：行はすべて削除します。）

Change catalog title URL_AP-1.png

 

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

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

  • Code 2xx（例：200）は、リクエストが正しく動作したことを示します。

Change catalog title URL_AP-2.png

 

API リクエストに成功すると、変更はすぐに Learn365管理センターに反映されます。

注記：

変更が反映されない場合は、ブラウザのキャッシュとクッキーを削除し、ページを再読み込みしてください。

参考 💡

以前のコースカタログ URLに戻すには、リダイレクトを削除して古い URL を解放する必要があります。詳細については、こちらの Microsoft のガイドをご覧ください。