2026年4月リリースのAPIの変更

Adobe Learning Managerの2026年4月リリースでは、代替と同等の機能、コンテンツへの時間枠によるアクセス、コンテンツ駆動型クイズの試行、ログインなしのエクスペリエンス、作業計画書の処理に関するパブリックAPIの重点的な機能強化が導入されています。 この変更は、下位互換性が高く、より正確な統合が可能になるように設計されています。

学習パスの適応型学習

このリリースでは、アダプティブ学習パスの完全なパブリックAPIサポートが追加されています。 学習パス(LP)では、どのセクションおよびサブ学習オブジェクト（サブLO）を、様々な学習者グループに対して表示するかを制御する、適応型ルールを定義できるようになりました。また、パブリックAPIはこの動作を反映します。

影響を受けるエンドポイントは次のとおりです。

新しいブール属性attributes.isAdaptiveは、学習プログラムがアダプティブルールを使用することを示します。 このフラグがtrueの場合、sections属性が適応的に解釈されます。

学習者呼び出しの場合は、現在の学習者に表示されているセクションのみが返されます。 各セクションには、セクションIDとともに、その学習者の適応設定に基づいて計算される学習目標ID(loId)、必須フラグおよびmandatoryLOCountのリストが含まれます。 relationships.subLOsリレーションもフィルタリングされるようになり、その学習者に表示されるサブ学習オブジェクトのみが含まれるようになりました。

管理者呼び出しの場合、セクションはadaptiveConfig配列をさらに公開できます。 userGroupId、userGroupName、およびそのグループにセクションが必須であるかどうかなど、ユーザーグループごとの適応規則を説明します。 管理者向けのツールでは、これを使用してアダプティブルールを視覚化および管理できます。

学習プログラムの完了のリセット

このリリースでは、適応型学習プログラムなどの学習目標に対して、更新（リセット）完了​のAPIが導入されています。 これにより、再トレーニング、定期的なコンプライアンス更新、プログラムの再起動などのシナリオがサポートされます。

新しいエンドポイントを使用できます。

POST /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/refreshCompletion

この操作には適切な書き込み権限が必要で、指定されたユーザーコンテキスト内の指定された学習オブジェクトインスタンスの完了状態がリセットされます。 これは、管理者側の自動化または慎重に範囲を設定した学習者ツールでの使用を目的としています。

この機能の一括バージョンは、ジョブAPIを介して計画されます。 「リクエスト」シェイプは、電子メール、ユーザーID、またはユーザーグループIDでユーザーをターゲットにするように設計されています。例：

{
  "emails": ["[user1@example.com](mailto:user1@example.com)", "[user2@example.com](mailto:user2@example.com)"],
  "userIds": ["12345", "67890"],
  "userGroupIds": ["ug1", "ug2"]
}

統合では、各プログラムまたはコースで学習者を再起動する必要がある場合、このAPIを使用する必要があります。 クライアントはエラー応答を適切に処理する必要があります。リセットを適用できない場合（完了が存在しない、サポートされていない学習オブジェクトタイプの場合など）、APIは更新要求を拒否することがあります。

対応する補完と代替補完

複数の学習オブジェクトが同じ要件を満たすことができる実装をサポートするために、このリリースでは同等の機能と代替機能の完了がパブリックAPIとして導入されています。

これで、学習目標エンドポイントに次の情報が含まれるようになります。

- GET /primeapi/v2/learningObjects
- GET /primeapi/v2/learningObjects/{loId}

新しいブール属性attributes.isAlternateCompleteは、特定の学習オブジェクトに対する学習者の完了が、オブジェクト自体ではなく代替または同等の学習オブジェクトのどちらに基づくかを示します。 これがtrueの場合、 relationships.alternateCompletions関係に、代替文字として機能した学習目標がリストされます。 これにより、ダウンストリーム・レポートおよびダッシュボードで、直接完了と代替完了を区別し、要件を満たした代替完了を表示できます。

さらに、関連学習目標ビューでは、学習目標を満たす可能性のある代替案を検出できます。 この情報は、次の方法で公開されます。

GET /primeapi/v2/learningObjects/{loId}/relatedLOs?type=sourceAlternateLOs&limit={n}

この応答は、代替文字として機能できる学習オブジェクトを返します。また、現在の制限とは無関係に、そのような代替文字の総数を示すmeta.countフィールドが含まれています。 統合はこれを使用して、推奨される同等の機能を提供したり、代替マッピングの管理ビューを作成したりできます。

レポートと分析のユースケース

レポートまたは分析を生成するユーザーは、ロジックを更新して、isAlternateCompleteとalternateCompletionsをレポートワークフローに追加する必要があります。

完了データ（LTエクスポート、カスタムデータウェアハウスフィード、BIダッシュボードなど）を消費するレポート統合では、LO APIからattributes.isAlternateCompleteとrelationships.alternateCompletionsの両方を読み取って保持するようにロジックが拡張される必要があります。

一般的な使用例：

この2つのフィールドが組み込まれていないと、下流のレポートで代替完了が通常の完了として扱われ、学習者が直接受講したことのないトレーニングを完了済みとして表示する​ *​理由​*を ​説明できなくなります。

学習者と管理者のLO APIの動作

多言語の作業計画書の構造は、学習者LOと管理者LOの両方のAPIで同じです。 学習者のスコープは、学習者が表示できる作業計画書のみを返しますが、表示される作業計画書ごとに、複数のリソースエンティティ（ロケールごとに1つ）と複数のロケールlocalizedMetadataを介してすべての設定済みロケールが表示されます。 管理者スコープは、同じLOモデルとロケール固有のリソースIDを使用して、管理者が管理できるすべての作業計画書を返します。 学習者の範囲を持つクライアントは、attributes.localeが学習者のコンテンツ言語と最も一致するリソースを選択する必要があります。一方、管理ツールは、レポートと管理のためにすべてのロケールを列挙できます。

コメント機能付きチェックリスト

このリリースでは、レビューアーがチェックリストベースのアクティビティに対して構造化されたフィードバックを共有できるワークフローをサポートするために、学習オブジェクトリソースAPIを介して​ チェックリストコメント ​とレビューアーの表示コントロールが表示されます。

チェックリスト関連のメタデータは、コースまたは他の学習目標内のチェックリストのリソースを表すlearningObjectResourceエンティティ(JApiLOResource、「type」:「learningObjectResource」)に公開されます。

この情報は、次の方法で取得できます。

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources

学習目標インスタンスにチェックリスト型リソースが含まれている場合、含まれている配列の対応するlearningObjectResourceエントリによって、属性の下にコメントとレビューアーの可視性属性、関係の下にレビューアーのIDが表示されます。

新しいチェックリストコメント属性

チェックリストリソースの場合、learningObjectResourceに次の属性が存在することがあります。

checklistEvaluationStatus、isChecklistMandatory、resourceSubType:「CHECKLIST」、submissionDateなどのその他のチェックリスト固有のコンテキストも同じlearningObjectResourceで使用でき、豊富なチェックリストUIとレポートをサポートします。

レビュー担当者のID関係

レビュー担当者の名前を表示する場合、learningObjectResourceには、レビュー担当者のユーザーを指す関係が含まれます。

"relationships": {
  "checklistReviewedBy": {
    "data": {
      "id": "user_id",
      "type": "user"
    }
  }
}

このリレーションシップは、の場合にのみ​入力されます：

クライアントアプリケーションは次の条件を満たす必要があります。

チェックリストのリソースとコメントへのアクセス

特定の学習目標に関するチェックリストリソースとそのコメントを取得するには、クライアントは次のことを行う必要があります。

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources

このパターンにより、ヘッドレスまたはカスタムクライアントは、ステータス、必須/オプションフラグ、レビュー担当者のフィードバックなどの包括的なチェックリストエクスペリエンスをPrime APIから直接レンダリングできます。

レポート作成とUXに関する考慮事項

作業計画書の多言語サポート

作業計画書を複数の言語で学習者と管理者の両方に配布する必要がある実装をサポートするために、このリリースでは作業計画書の処理が拡張され、ロケールごとに1つのリソース​を返します。ハードコードされたen-USリソースは1つではありません。

多言語の作業計画書では、既存の階層が引き続き使用されます。

学習目標 (lo) → learningObjectResource (loResource) → リソース

API契約に変更を加える必要はありません。 ローカライズされた作業計画書は、ロケールごとに個別のリソースエンティティを持ち、ローカライズされたメタデータをlearningObject/learningObjectResourceレベルで共有することで、自然にこの構造に適合します。

作業計画書のデータは、次の方法で公開されます。

GET /primeapi/v2/learningObjects/jobAid:{jobAidId}?include=instances.loResources.resources

作業計画書に複数の言語のバリアントが含まれている場合、含まれる配列には複数の「タイプ」、「リソース」エントリが含まれます。これは、ロケールごとに1つ（en-US、fr-FR、es-ESなど）のエントリで、すべて単一のlearningObjectResourceからリンクされています。

多言語の作業計画書の構造

多言語の作業計画書の使用：

多言語の作業計画書の場合、一般的なパターンは次のとおりです。

学習者のロケールをresource.attributes.localeフィールドと一致させることで、クライアントは適切なリソースを選択できます。

作業計画書の新しいリソースID形式

作業計画書リソースの複数のローカライズされたバリエーションを正しく区別するために、リソースIDの形式が変更されました。

古い（レガシ）リソースID形式

以前は、作業計画書のリソースで、次のような不透明なID形式が使用されていました。

作業計画書:131032_-1_-1_2_resource

この形式ではロケールはエンコードされず、APIは実質的に1つのリソース（通常はen-US）のみを公開します。

新しいリソースID形式（多言語対応）

新しい形式は次のとおりです。

jobAid:<jobAidId>_<version>_<localeCode>

例：

視覚的な内訳：

jobAid:131032_2_fr_FR

        │      │ │ │

        │      │ │ └──► Locale Code (fr_FR, en_US, es_ES, etc.)

        │      │ └────► Version (2)

        │      └──────► JobAid ID (131032)

        └─────────────► Resource Type Prefix ("jobAid:")

この構造体を使用すると、クライアントは次の操作を実行できます。

下位互換性：

/resources/{resourceId}

従来のリソースエンドポイントは引き続き使用できます。

古いID形式と新しいID形式の両方で​ 下位互換性 ​があります。

現在、古いリソースIDを保存または参照している統合は、変更なく機能し続けることができます。一方、新しい実装では、ロケール固有の操作に新しいID形式を採用することをお勧めします。

統合とUXに関する考慮事項

開始モジュールのタイムスロット制約

一部の学習体験は、定義された時間枠内でのみ利用できる必要があります。 このリリースでは、学習目標リソースのタイムスロット情報が表示され、学習者が現在の時間でリソースを開始できるかどうかをチェックする検証エンドポイントが導入されています。

タイムスロットメタデータは、エンドポイントを介して使用できます。

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources

学習オブジェクトリソースレベルでは、timeSlotオブジェクトが属性に存在し、startTimeとendTimeの値がUTCになります。 リソースを起動する期間を指定します。

モジュールを起動する前に、統合は新しい検証エンドポイントを呼び出すことができます。

GET /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/loResources/{loResourceId}/canStart

このエンドポイントは、学習者が読み取るシナリオ向けであり、設定された時間帯、配信タイプ、およびその他のバックエンドルールを考慮して、学習者が現在リソースを開始できるかどうかを返します。

カスタムプレーヤーとクライアントアプリケーションは、canStartを使用して時間ベースのアクセスを強制し、timeSlotメタデータを使用して、コンテンツが利用可能になった時期や期限切れになった時期に関する明確なメッセージを表示する必要があります。 canStartからの否定的な回答は、コンテンツをまだ開始できなくなった理由や終了した理由を学習者に知らせるために、明示的に処理する必要があります。

複数試行のコンテンツドリブンのクイズ

一部のコンテンツパッケージは、Adobe Learning Managerだけに依存するのではなく、独自の試行追跡を実装しています。 このリリースでは、試行がコンテンツ自体によって行われたことを示すフラグが導入されています。

スルー：

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources

学習オブジェクトリソースは、ブール属性hasContentDrivenAttemptTrackingを公開できるようになりました。 この場合、クイズまたはモジュールは（SCORMやxAPIロジックなどを介して）試行を内部的に管理します。プラットフォームの標準試行カウンターは、学習者のエクスペリエンスを完全には反映していない場合があります。

試行回数を表示する統合、または再試行動作を制御する統合では、このフラグをチェックする必要があります。 有効な場合は、プラットフォームのメタデータのみから試行制限を推測するのではなく、コンテンツ側のレポート（例えば、xAPIステートメントを介して）またはビジネス固有のルールに依存できるようにする必要があります。

作業計画書リソースID形式の行動変更

このリリースでは、作業計画書のリソースIDの形式に重要な​ 動作の変更 ​が導入されています。 新しいエンドポイントは必要ありませんが、これは、これらのIDを保存または解析するシステムに直接影響を与えます。

以前は、作業計画書のリソースIDは次のような形式を使用していました。

jobAid:<jobAidId>_-1_-1_2_resource

2026年4月のリリースでは、これは簡略化されたより明確な形式に置き換えられました。

jobAid:<jobAidId>_<version>_<localeCode>

以下に例を示します。

作業計画書:131032_2_fr_FR

コンポーネントは次のとおりです。

リソースをインデックス化する、または作業計画書のリソースIDに保持する統合は、解析ロジックとストレージロジックを更新して、新しい形式を認識する必要があります。 ID自体が変更されるため、2026年4月のリリースにアップグレードした後で、作業計画書のリソースIDによってキー設定されたローカルインデックスを再構築することを強くお勧めします。

移行によるコースバナー画像の設定

標準の移行ワークフローの一環として、Adobe Learning Managerでコースバナー画像を設定または更新できるようになりました。 これにより、大きなカタログを起動したりクリーンアップしたりする際に、コースページの表示を手動で編集することなく、一貫した状態を保つことができます

バナー画像の定義場所

バナー画像は​ course.csv ​移行ファイルで設定されます。このファイルは、次のようなコースメタデータを提供するために既に使用しています。

この機能強化により、course.csv仕様にコースバナー画像の​ オプション列 ​が追加されました。 正確なヘッダー名は、Learning ManagerアカウントからダウンロードしたCSV仕様で定義されます（例えば、bannerUrlやbannerImageUrlと表示される場合があります）。

バナー列：

移行のためのバナー画像の準備

id,courseName,courseCreationDate,state,author,thumbnailUrl,bannerUrl
12345,DEMO1,2018-05-05T08:56:21.000Z,Published,Sudheer,pic1.png,banners/banner1.png
45678,DEMO2,2018-05-05T08:56:21.000Z,Published,Sudheer,pic2.png,banners/banner2.png

移行実行中のバナーの適用

course.csvが更新されると、フローは他の移行と同じになります。

新規コースと既存コースの比較

バナーフィールドは、次の両方のシナリオで機能します。

実際の列名とパスは、ダウンロードされたCSV仕様​とコンテンツリポジトリレイアウトと一致している必要があります。

LearningProgramCourseの「順序」列を削除

Adobe Learning Managerでは、移行中の​ 学習パス（学習プログラム）内のコース順序 ​の簡略化されたモデルがサポートされるようになりました。 この変更の一部として、learning program course.csv移行ファイルから_order列が削除されます_。

以前は、learning_program_course.csvファイルに、次の目的で使用する列（通常、orderまたは同様の列）が含まれていました。

Adobe Learning Managerでは、learning_program_course.csvの「順序」列を使用して、コースの順序が決定されなくなりました。 移行CSVでは、数値順ではなく、どのコースがどの学習プログラムに属しているかに​焦点が当てられます。

移行CSVへの影響

learning_program_course.csv

従来の注文列は削除または無視されたものとして扱う必要があります。

現在のヘッダーセットと要件を確認するには、常にLearning Managerアカウントから（csv _specifications.zipを介して）最新の_ CSV仕様_を参照します。

コースインスタンスのtimeZoneCode

このリリース以降、コースインスタンスモデル(learningObjectInstance)には次のような新しい属性が公開されます。

timeZoneCode – アカウントで設定されているタイムゾーンに、コースインスタンスを明示的にリンクする文字列フィールド。

これにより、クライアントは次のことが可能になります。

timeZoneCodeの表示場所

フィールドはlearningObjectInstanceモデルの属性に追加されます
コースインスタンスのみ。

例：

{
  "id": "course:1262748_1359228",
  "type": "learningObjectInstance",
  "attributes": {
    "dateCreated": "2019-08-06T13:50:39.000Z",
    "isAET": false,
    "isDefault": true,
    "timeZoneCode": "356",
    "isFlexible": false,
    "state": "Active",
    "localizedMetadata": [
      {
        "locale": "en-US",
        "name": "Default instance"
      }
    ]
  }
}

timeZoneCodeの解決方法

数値timeZoneCodeは、アカウントAPIを介して公開されるアカウントのタイムゾーンカタログへの参照キーです。

GET /primeapi/v2/account
Authorization: Bearer <access_token>

応答の中で、タイムゾーンは次の場所にリストされます。

"data": {
  "attributes": {
    "timeZones": [
      {
        "name": "Etc/GMT+12",
        "timeZoneCode": "356",
        "utcOffset": -720,
        "utcOffsetCode": "UTC-12:00(Etc/GMT+12)",
        "zoneId": "Etc/GMT+12"
      },
      "..."
    ]
  }
}

推奨されるクライアントフロー：

ユーザーグループのメンバーシップ用の非同期パブリックAPI

概要

Adobe Learning Managerは、ユーザーグループ(UG)メンバーシップを管理するための2つの​ admin async API ​を公開しています。

これらのAPIは、同じ要求でメンバーシップを更新するのではなく、バッチを受け入れ、イベントID​を返します。 実際の結果は、後でWebhookを介して配信されます。

次の場合に使用します。

小規模で対話的な管理者アクションの場合は、引き続き同期/userGroups/{id}/users APIを使用できます。

認証とベースURL

これらのAPIは、標準の​ v2 Admin API ​サーフェスの一部です。

一般的なAdmin APIの動作とスコープについては、次を参照してください。

形式をリクエスト

add​と​ remove ​ではまったく同じボディの形状を使用しています。

本文

{
  "metadata": {
    "event_id": "my-optional-correlation-id",
    "sourceSystem": "HRIS",
    "batchId": "hr_2026_03_30_0001"
  },
  "data": [
    { "type": "user", "id": "11101219" },
    { "type": "user", "id": "11101220" }
  ]
}

データ（必須）

dataは、このバッチのユーザー・リソース識別子のリストです。

制約

これらの条件のいずれかに失敗した場合、APIはエラーを返し、キューに何も格納されません。

メタデータ（オプション）

metadataは、Webhookにエコーバックする追加の相関データです。

一般的な使用方法：

サービスは、Webhook応答でこのオブジェクトを変更せずに返すので、コールバックを内部ジョブと一致させることができます。

制約：

応答形式

両方のエンドポイントが、イベントIDを使用して同期的に応答します。

{ "event_id": "cd2972c8-cb15-47a0-a23f-e4a16cb720f5" }

動作：

常に次のことを行う必要があります。

詳細については、ユーザーグループメンバーシップを追加および削除するためのWebhookを表示してください。

よくある質問

2026年4月のリリースでは、アダプティブ学習プログラム用のlearningObjects APIはどのように変更されますか？

このリリースでは、学習プログラムにisAdaptiveフラグが追加され、セクションとサブLOが学習者に対応するようになりました。 適応プログラムでは、適応規則に基づいて表示されるセクションとサブ学習オブジェクトのみが学習者に対して表示され、ユーザーグループの基本的な適応設定は管理者が表示できます。

すべてのセクションとサブLOが常に返されると想定される場合、統合を更新する必要がありますか？

はい。 適応型学習プログラムの場合、APIは現在の学習者に表示されるセクションとサブLOのみを返すようになりました。 クライアントコードは、応答を完全なリストと見なすのではなく、信頼できる、場合によってはフィルタされたビューとして扱う必要があります。

コースまたは学習プログラムに対する学習者の完了をプログラムでリセットするにはどうすればよいですか？

新しいエンドポイントの使用：

POST /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/refreshCompletion
これにより、アクセス許可と状態で許可されている場合、ターゲットのインスタンスの完了がリセットされます。

学習者が別の学習目標または同等の学習目標で完了したかどうかを確認する方法を教えてください。

学習目標のisAlternateComplete属性を確認します。 trueの場合、alternateCompletions関係に、その学習者の完了の代替手段として機能した学習目標がリストされます。

特定の学習目標を満たす代替をすべて検索する方法を教えてください。

次のエンドポイントを使用します。

GET /primeapi/v2/learningObjects/{loId}/relatedLOs?type=sourceAlternateLOs&limit={n}

また、データ配列（代替文字の場合）とmeta.count（代替文字の総数の場合）を使用します。

現時点で学習者がモジュールの開始を許可されているかどうかを確認するにはどうすればよいですか？

まず、次の場所からリソースのtimeSlotを取得します。

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources
その後、次のコマンドを使用します。

GET /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/loResources/{loResourceId}/canStart

hasContentDrivenAttemptTrackingはリソースについて何を意味しますか？

これは、試行のトラッキングが、プラットフォームのカウンターのみではなく、コンテンツ自体（SCORM/xAPIロジックなど）によって制御されることを示します。 これが真実であれば、プラットフォームの試行回数や制限のみに頼ってUXとレポートを作成しないでください。

ログインしていないユーザー（パブリックエクスペリエンス）に適したメニューを取得するにはどうすればよいですか？

使用：

GET /primeapi/v2/templates/menus?include=pages,subMenus.pages&isNonLoggedIn=true

これにより、匿名ユーザー用にフィルターされたメニューおよびページの構造が返されます。これは、Experience Builderなどのヘッドレスサイトに適しています。

effectiveModifiedDateを使用した作業計画書のフィルタリングで何が変更されましたか？

filter.effectiveModifiedDateとfilter.loTypes=jobAidを組み合わせたリクエストで、指定された日付ウィンドウ内の作業計画書のみが正しく返されるようになりました。

作業計画書のリソースID形式の変更点と対処方法

ID形式が次のような値から変更されました。

jobAid:<jobAidId>_-1_-1_2_resource

宛先：

jobAid:<jobAidId>_<version>_<localeCode>

例： jobAid:131032_2_fr_FR。 作業計画書のリソースIDを保存または解析するシステムはすべて更新する必要があります。2026年4月のリリースにアップグレードした後、これらのIDによってキー設定されたローカルインデックスの再構築を計画する必要があります。