Adobe Learning Manager 中的 API 棄用與變更
2024 年 3 月 Adobe Learning Manager 版本中的 API 棄用
抵消限額的變更
由於偏移值會取得大量紀錄,導致整體效能變慢,我們強制執行最多 500 筆紀錄。 在下一個版本中,對於管理員和學習者 ,GET Users API 最多可回傳 500 筆紀錄。
如果你需要更多紀錄來取得,可以使用 GET Jobs API。
哪些路徑會被棄用
以下路徑已被棄用:
-
/learningObjects
-
已棄用路徑:
- enrollment.loInstance.loResources.resources
- instances.loResources.resources
-
新路線:
- enrollment.loInstance.loResources
- instances.loResources
-
-
/learningObjects/
- 已棄用路徑:
- enrollment.instances.subLoInstances.learningObject
- 新路線:
- enrollment.instances.subLoInstances
- 已棄用路徑:
-
/註冊人數
- 已棄用路徑:
- loInstance.learningObject.enrollment
- 新路線:
- loInstance.learningObject
- 已棄用路徑:
-
/learningObjects/
- 已棄用路徑:
- instance.subLoInstances.learningObject.enrollment.loResourceGrades
- 新路線:
- instance.subLoInstances
- 已棄用路徑:
依名稱排序
在 Adobe Learning Manager 的下一版本中,以下 API 的排序欄位中已不再使用 name 和 –name:
- 取得 /userGroups/{userGroupId}/users
- 取得 /users
2023 年 11 月 Adobe Learning Manager 版本中的 API 棄用
覆寫旗標
在 2023 年 11 月的 Adobe Learning Manager 版本中,我們已停止對 API 的覆寫標記。 覆寫旗標並非公開 API 規範的一部分,主要用於後端測試。 該旗標現已停止用於學習者 API。 不過,該旗標對於管理 API 仍然有效。
我們之所以棄用 Learner API 的旗標,是因為覆蓋旗標透過 Learner API 取得大量資料。
未來,以下的 Learner API 將因覆蓋標誌而停止運作。
/primeapi/v2/users?page[offset]=0&page[limit]=10&sort=id&override=TRUE
基於技能的新建議 API 變更
Adobe Learning Manager 改善了客戶與合作夥伴啟用帳號的建議。 推薦演算法的改進,加上課程、學習路徑與認證排名演算法的改變,為使用者在內容發現上提供了更佳的體驗。
演算法將不再允許基於同儕的推薦。 此變更不會影響現有用戶,但產業整合選項仍將持續存在。 自訂選項中,Adobe Learning Manager 將不再允許自訂同儕選擇。
同儕群組現在變成一個帳號,學習者會看到一串顯示群組中熱門主題的串。 所有建議都是可以解釋的。 例如,如果你正在觀看某個主題的內容,條帶上的卡片會顯示該課程的理由。
通知公告報告變更
在早期的 Adobe Learning Manager 版本中,通知公告報告沒有任何篩選功能。 Adobe Learning Manager 下載了帳號內的所有通知。
在 2023 年 11 月的版本中,我們新增了日期篩選器,您可以透過此在指定期間內下載通知。 不過,你只能下載過去六個月的報告。
GET /users 端點中高偏移值的棄用
為了提升系統效能並更有效管理資源利用率,Adobe 已棄用 GET /users 端點中 ADMIN 與 LEARNER 範圍的高偏移值。我們建議使用 Jobs API 來取得帶有偏移值的紀錄。