Adobe Learning Managerの2026年9月リリースのAPIの変更
学習目標のカタログアクセスをチェックするためのAPI
学習者が学習パスまたは資格認定を通じてコンテンツに到達したかどうかにかかわらず、現在の学習者が1つ以上の学習オブジェクトに直接カタログ経由でアクセスできるかどうかを確認します。
APIの目的
学習者が学習パスや資格認定を開くと、カタログを通じて特定のコースが学習者に直接割り当てられていない場合でも、学習者は学習パスや資格認定に含まれる個々のコースを参照できます。 これはコンテンツ発見をサポートします。学習者は、学習パスを進めるかどうかを決定する前に、学習パスに含まれている内容を調べることができます。
ただし、この方法でコースを表示できるからといって、学習者がコースに自動的に登録できるわけではありません。 登録は、含まれている学習パスを介した間接的なアクセスだけでなく、学習者がその特定のコースに直接カタログからアクセスできるかどうかによって異なります。
このAPIを使用すると、特定の学習者に割り当てられたカタログを通じて1つ以上の学習目標に直接アクセスできるかどうかを確認できます。 結果を使用して、登録関連のUIを制御できます。例えば、コースページ自体を両方の場合に表示しながら、カタログへの直接アクセスが確認されたときにのみ「登録」オプションを表示します。
エンドポイント
GET /primeapi/v2/learningObjects/isMemberOfVisibleCatalogs
クエリパラメーター
リクエストの例
GET /primeapi/v2/learningObjects/isMemberOfVisibleCatalogs?ids=course%3A2400159%2Ccourse%3A2400160%2Ccourse%3A2400161%2Ccourse%3A2400162
Accept: application/vnd.api+json
Authorization: oauth <access-token>
応答例 – 200 OK
{
"course:2400162": false,
"course:2400161": false,
"course:2400160": true,
"course:2400159": true
}
応答コード
エラー応答の例
{
"status": "BAD_REQUEST",
"title": "Bad request. Check url, params and headers",
"source": {
"info": "Either LO id is blank or not as per public api specification"
}
}
統合でこのAPIを使用する
一般的なユースケースは、学習者が学習パスから移動して到達するコースページです。 検出のためにコースページ自体にアクセスできるようにする一方で、学習者がコースに直接カタログへのアクセス権を持っている場合にのみ 登録 アクションを表示する必要があります。
- コースページが読み込まれたら、コースの学習目標IDを使用してこのエンドポイントを呼び出します。
- そのIDに対して応答がtrueを返した場合は、登録オプションを表示します。
- 応答がfalseを返した場合、コースページの表示、タイトル、説明、コースの詳細は保持し、登録オプションは非表示にします。
管理者監査追跡レポートのジョブAPI apiaudittrailreport
APIの目的
管理者監査追跡レポートには、次の操作に対して行われた構成変更が一覧表示されます
Adobe Learning Managerアカウント 例えば、基本、統合、
指定した日付範囲の高度なアカウント設定。 監査追跡レポートを生成するには、要求された日付範囲および設定タイプにわたって構成変更レコードを照会および集計する必要があります。 範囲のサイズと変更の量によっては、同期HTTP要求の時間制限を超える場合があり、同期HTTP要求はクライアントまたはゲートウェイのタイムアウトのリスクがあります。
これを回避するために、レポートは一般的なジョブAPIを介して非同期で生成されます。
-
ジョブの作成 管理者は、レポートタイプ、日付範囲、設定タイプを指定したリクエストを送信します。 APIは、レポートのコンパイルを待たずに、すぐにジョブIDを返します。
-
ジョブをポーリングします。 管理者は定期的にIDを使用してジョブを取得し、ステータスを確認します。 ジョブが完了すると、応答に結果または結果への参照が含まれます。
ベースURLと規則
/primeapi/v2application/vnd.api+json;charset=UTF-8 (JSON:API)x-acap-accountヘッダーstatusがQUEUEDまたはIN_PROGRESSでなくなるまで、ジョブ状態の取得エンドポイントをポーリングしますID
ジョブの作成時に返されるジョブidは不透明な文字列です(例:4593). 作成から受け取った正確なid値を常に返します
ステータスのポーリング時の応答。 決して構築したり解析したりしないでください。
認証スコープ
各エンドポイントには、次のスコープを持つOAuthトークンと、
呼び出し元ユーザーは、アカウント管理者の役割を保持する必要があります。
admin:writeレポートジョブを作成します(ROLE_ADMIN必須)admin:readがジョブの状態と結果を読み取りました(ROLE_ADMIN必須)
アカウントにROLE_ADMINを持っていない発信者からの要求は次のとおりです
拒否されました。エラー処理を参照してください
端点
監査追跡レポートジョブの作成
POST /primeapi/v2/jobs
構成変更監査追跡レポートを生成する非同期ジョブを作成します
に設定できます。 応答はすぐに返されますQUEUED状態のジョブリソースでは、レポート自体は
背景:
スコープ: admin:write
jobTypegenerateConfigChangeAuditReportである必要がありますpayload.fromDate2026-09-15T00:00:00.000+05:30payload.toDate2026-09-23T23:59:59.000+05:30payload.settingTypesBasics、Integrations、およびAdvancedですサンプルリクエスト本文
{
"data": {
"type": "job",
"attributes": {
"jobType": "generateConfigChangeAuditReport",
"payload": {
"fromDate": "2026-09-15T00:00:00.000+05:30",
"toDate": "2026-09-23T23:59:59.000+05:30",
"settingTypes": ["Basics", "Integrations", "Advanced"]
}
}
}
}
応答: 202 Created。 レスポンス本文は、その最初のジョブ・リソースですQUEUED状態。
{
"data": {
"id": "4593",
"type": "job",
"attributes": {
"jobType": "generateConfigChangeAuditReport",
"status": "QUEUED",
"dateCreated": "2026-09-23T18:12:04.000+05:30"
}
}
}
fromDate/toDateウィンドウ、または長い変更履歴を持つアカウントに対してすべての設定タイプを要求し、次のことを実行できます
処理に時間がかかる。 代わりにジョブの状態の取得エンドポイントをポーリングします
一定の遅延後にレポートの準備が整っていると仮定します。
監査追跡レポートジョブのステータスを取得する
GET /primeapi/v2/jobs/{id}
以前に作成されたジョブの現在のステータスを返します。 仕事をしている間
実行中、attributes.statusはQUEUEDまたはIN_PROGRESSで、attributes.resultが存在しません。 ジョブが完了すると、attributes.statusはCOMPLETED、attributes.resultのレポートの場所、またはFAILED、エラーの詳細: attributes.error。
スコープ: admin:read
idジョブの実行中のサンプル応答
{
"data": {
"id": "4593",
"type": "job",
"attributes": {
"jobType": "generateConfigChangeAuditReport",
"status": "IN_PROGRESS",
"dateCreated": "2026-09-23T18:12:04.000+05:30"
}
}
}
ジョブが完了した後のサンプル応答
{
"data": {
"id": "4593",
"type": "job",
"attributes": {
"jobType": "generateConfigChangeAuditReport",
"status": "COMPLETED",
"dateCreated": "2026-09-23T18:12:04.000+05:30",
"dateCompleted": "2026-09-23T18:12:41.000+05:30",
"result": {
"downloadUrl": "https://learningmanager.adobe.com/primeapi/v2/jobs/4593/download",
"expiresAt": "2026-09-24T18:12:41.000+05:30"
}
}
}
}
リソーススキーマ
ジョブ属性
idjobTypegenerateConfigChangeAuditReportstatusQUEUED、IN_PROGRESS、COMPLETEDまたはFAILEDdateCreateddateCompletedstatusがCOMPLETEDまたはFAILEDになったときに存在します。payloadresultstatusがCOMPLETEDの場合にのみ表示されます(埋め込み – 以下を参照)errorstatusがFAILEDの場合にのみ存在します。ペイロード(埋め込み、作成リクエスト内)
fromDatetoDatesettingTypesBasics、Integrations、Advanced結果(埋め込み、完了したジョブ内)
downloadUrlexpiresAtdownloadUrlが有効でなくなったら、新しい状態チェックを要求して、この時刻を過ぎると新しいリンクを取得しますエラー処理 audit-trail-report-error-handling
これらのエンドポイントには、次のコードが適用されます。
BAD_REQUESTtoDateがfromDateより前です。settingTypesが空か、サポートされていない値を含んでいるか、日付が有効なISO-8601 – エンドポイントの作成のみ有効ではありませんUNAUTHORIZED_ACCESSFORBIDDENROLE_ADMINを保持していませんOBJECT_DOESNT_EXISTエラー応答の例
{
"status": "BAD_REQUEST",
"title": "Bad request. Check url, params and headers",
"source": {
"info": "toDate must be on or after fromDate"
}
}
統合でこのAPIを使用する
一般的なユースケースは、管理者向けの「監査追跡をダウンロード」アクションです。
アカウント設定画面
- 管理者が日付範囲と1つ以上の設定タイプを選択し、
これらの値を使用してcreate-jobエンドポイントを呼び出すことを確認します。 - 返されたジョブ
idを保存し、ジョブ状態の取得エンドポイントをポーリングします
妥当な間隔(例、数秒ごと)。 statusがQUEUEDまたはIN_PROGRESSである間、進行状況の状態を表示し続けます
をクリックします。statusがCOMPLETEDになると、result.downloadUrlを使用してexpiresAtが成功する前に管理者がレポートをダウンロードします。statusがFAILEDになると、管理者にerrorを表示して許可します
再試行します。