Adobe Learning ManagerでのAPIの廃止と変更

Adobe Learning Managerの2024年3月リリースのAPIの廃止

オフセット制限の変更

オフセット値によって取得されるレコード数が多いため、全体的なパフォーマンスが低下し、500 ​レコードの制限が適用されます。 次回のリリースでは、管理者と学習者の両方に対して、GETユーザー APIで最大​ 500 ​件のレコードが返されます。

さらにレコードを取得する必要がある場合は、GETジョブ APIを使用してください。

非推奨のパス

次のパスは非推奨です。

  • /learningObjects

    • 非推奨のパス:

      • enrollment.loInstance.loResources.resources
      • instances.loResources.resources
    • 新しいパス:

      • enrollment.loInstance.loResources
      • instances.loResources
  • /learningObjects/

    • 非推奨のパス:
      • enrollment.instances.subLoInstances.learningObject
    • 新しいパス:
      • enrollment.instances.subLoInstances
  • /enrollments

    • 非推奨のパス:
      • loInstance.learningObject.enrollment
    • 新しいパス:
      • loInstance.learningObject
  • /learningObjects/

    • 非推奨のパス:
      • instance.subLoInstances.learningObject.enrollment.loResourceGrades
    • 新しいパス:
      • instance.subLoInstances

名前で並べ替え

Adobe Learning Managerの次のリリースでは、次のAPIの並べ替えフィールドでnameと – nameが非推奨になりました。

  • GET /userGroups/{userGroupId}/users
  • GET/ユーザー
NOTE
既存および新規のすべてのアカウントでは、名前で並べ替えおよび – nameは使用できなくなります。

Adobe Learning Managerの2023年11月リリースのAPIの廃止

上書きフラグ

Adobe Learning Managerの2023年11月リリースでは、APIからのオーバーライドフラグが廃止されました。 上書きフラグはパブリック API 仕様の一部ではなく、バックエンドテストでの使用を目的としています。 学習者 API のフラグは廃止されました。 ただし、このフラグは管理者用 API に対して引き続き有効です。

学習者APIのフラグを廃止する理由は、オーバーライドフラグにより学習者APIを介して大量のデータが取得されていたためです。

今後、次の学習者 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月のリリースでは、日付フィルターが追加され、指定した期間内の通知をダウンロードできるようになりました。 ただし、過去6か月間のレポートのみをダウンロードできます。

GET/usersエンドポイントの高いオフセット値の廃止

システムパフォーマンスを向上させ、リソース使用率をより効果的に管理するために、Adobeは、ADMIN ​と​ LEARNER ​の両方のスコープのGET/usersエンドポイントの高オフセット値を廃止しました。 ジョブAPI ​を使用して、オフセット値を持つレコードを取得することをお勧めします。

recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d