Learn365 API では、テナントで利用可能な目標スキルの定義のリストを取得することができます。
ここでは、API を使用してテナント内の目標スキルの定義のリスト、特定の定義に関する詳細情報、および特定のユーザーに適用されている定義のリストを取得する方法について説明します。
Learn365 管理センターの目標スキルの定義については、こちらをご参照ください。
テナント内の目標スキルの定義を取得する
手順：
1．API にアクセスし、認証を行います。
https://api.365.systems/ にアクセスし、適切な API キーで認証されていることを確認してください。
2．エンドポイントを選択します。
TargetSkills セクション で以下のエンドポイントを選択し、右上の［Try it out］をクリックします。
GET /services/skills/TargetSkills Returns all target skills
3．必要に応じて、クエリ オプション パラメータを入力します。
クエリ オプション パラメーター を入力しない場合、レスポンスにはテナント上のすべての目標スキルに関する情報が含まれます。
クエリ パラメータの例：$filter パラメータを使って、条件に合うデータだけを絞り込んで取得できます。
- Name：目標スキルの定義のタイトルを指定して、そのデータのみを取得します。
- isGlobal：目標スキルの定義の「グローバル」オプション設定（true または false）で絞り込みます。true の場合、組織全体が対象の定義のみを取得します。
補足：
特定の目標スキルの定義の ID がわかっている場合、ID を使って特定の定義のみを取得できます。この場合、以下のエンドポイントを使用します。
GET /services/skills/TargetSkills/{id}
4．［Execute］をクリックしてリクエストを実行します。
5．「Responses」ブロックで結果を確認します。
- ステータスコード 200 が返され、レスポンス本文に目標スキルの定義の一覧が表示された場合は成功です。
- 各目標スキルの定義には、それぞれに Id、Name、isGlobal の情報が含まれます。
- エラーが発生した場合は、レスポンス本文にエラーオブジェクトが含まれます。このオブジェクトには、エラー内容を示す code と message が含まれており、問題の原因を確認できます。
特定のユーザーに適用された定義を取得する
特定のユーザーに対して適用されている目標スキルの定義を、ユーザーごとにグループ化して取得します。
手順：
1．API にアクセスし、認証を行います。
https://api.365.systems/ にアクセスし、適切な API キーで認証されていることを確認してください。
2．エンドポイントを選択します。
TargetSkills セクション で以下のエンドポイントを選択し、右上の［Try it out］をクリックします。
POST /services/skills/TargetSkills/ByUsers
3．リクエスト body にユーザー ID を入力します。カンマ区切りで複数入力できます。
ユーザー ID は API を使用して取得できます。詳細な手順についてはこちらのドキュメントをご参照ください。
記入例：
{
"userIds": [ "fa716ed4-d19f-474b-b9b7-05fcd50532fb", "bbee9b29-5109-49e1-1a2e-08dd138685f0"]
}
4．［Execute］をクリックしてリクエストを実行します。
5．「Responses」ブロックで結果を確認します。
- ステータスコード 200 が返され、レスポンス本文にユーザー ID と目標スキルの定義の一覧が表示された場合は成功です。
- ユーザーに設定されている目標スキルの定義と適用条件、各目標スキルの定義の詳細情報が含まれます。
- エラーが発生した場合は、レスポンス本文にエラーオブジェクトが含まれます。このオブジェクトには、エラー内容を示す code と message が含まれており、問題の原因を確認できます。