Adobe Learning Manager 2026년 9월 릴리스의 API 변경 사항

학습 객체의 카탈로그 액세스 확인을 위한 API

학습자가 학습 경로 또는 인증을 통해 해당 콘텐츠에 도달했는지 여부와 관계없이 현재 학습자가 하나 이상의 학습 개체에 대한 직접 카탈로그 액세스 권한을 보유하고 있는지 확인합니다.

API의 목적

학습자가 학습 경로나 인증을 열 때 카탈로그를 통해 특정 강의에 직접 할당되지 않았더라도 그 안의 개별 강의를 찾아볼 수 있습니다. 이는 콘텐츠 발견을 지원합니다. 학습자는 학습 경로의 추적 여부를 결정하기 전에 학습 경로에 포함된 내용을 탐색할 수 있습니다.

그러나 이러한 방식으로 강의를 볼 수 있다고 해서 학습자가 강의에 자동으로 등록할 수 있는 것은 아닙니다. 등록은 학습자가 포함된 학습 경로를 통한 간접 액세스가 아니라 해당 특정 강의에 대한 직접 카탈로그 액세스 권한이 있는지 여부에 따라 달라집니다.

이 API를 사용하면 지정된 학습자에 대해 할당된 카탈로그를 통해 하나 이상의 학습 객체에 직접 액세스할 수 있는지 여부를 확인할 수 있습니다. 결과를 사용하여 등록 관련 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 사용

일반적인 사용 사례는 학습자가 학습 경로에서 탐색하여 도달한 강의 페이지입니다. 학습자가 강의에 직접 카탈로그 액세스할 수 있는 경우에만 등록 동작을 표시하면서 강의 페이지 자체에 액세스할 수 있는 상태를 유지하려고 합니다.

관리자 감사 추적 보고서용 작업 API apiaudittrailreport

API의 목적

관리자 감사 추적 보고서에는 다음에 대한 구성 변경 사항이 나열됩니다
Adobe Learning Manager 계정입니다. (예: 기본, 통합 또는
지정된 날짜 범위에 대한 고급 계정 설정. 감사 추적 보고서를 생성하려면 요청된 날짜 범위 및 설정 유형에 걸쳐 구성 변경 레코드를 쿼리하고 집계해야 합니다. 범위의 크기와 변경 볼륨에 따라, 동기 HTTP 요청의 시간 제한을 초과할 수 있습니다. 이 경우 클라이언트 또는 게이트웨이 시간 초과가 발생할 수 있습니다.

이를 방지하려면 일반 작업 API를 통해 보고서가 비동기적으로 생성됩니다.

기본 URL 및 규칙

ID

작업을 만들 때 반환된 id 작업은 불투명 문자열입니다(예:
4593). 항상 만들기 작업을 통해 받은 id 값을 다시 전달하세요.
상태를 폴링할 때의 응답입니다. 구문 분석하거나 구문 분석하지 마십시오.

인증 범위

각 엔드포인트에는 다음 범위를 포함하는 OAuth 토큰이 필요합니다.
호출 사용자에게 계정 관리자 역할이 있어야 합니다.

계정에 ROLE_ADMIN을(를) 보유하지 않은 호출자의 요청:
거부됨: 오류 처리를 참조하십시오.

끝점

감사 추적 보고서 작업 만들기

POST /primeapi/v2/jobs

구성 변경 감사 추적 보고서를 생성하는 비동기 작업을 생성합니다.
지정된 날짜 범위 및 설정 유형에 대한 응답이 즉시 반환됩니다
작업 리소스가 QUEUED 상태인 경우 보고서 자체는
배경입니다.

범위: admin:write

샘플 요청 본문

{
  "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"
    }
  }
}

감사 추적 보고서 작업의 상태 가져오기

GET /primeapi/v2/jobs/{id}

이전에 만든 작업의 현재 상태를 반환합니다. 작업 기간
아직 실행 중입니다. attributes.status은(는) QUEUED 또는 IN_PROGRESS이고
attributes.result이(가) 없습니다. 작업이 완료되면 attributes.status은(는)
COMPLETED, 보고서 위치가 attributes.result인 경우 또는
FAILED, 오류 세부 정보가 attributes.error에 있습니다.

범위: admin:read

작업이 아직 실행 중인 동안의 샘플 응답

{
  "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"
      }
    }
  }
}

리소스 스키마

작업 속성

페이로드(포함, 만들기 요청 내)

결과(완료된 작업 내에 포함됨)

오류 처리 audit-trail-report-error-handling

다음 코드는 이러한 엔드포인트에 적용됩니다.

오류 응답 예

{
  "status": "BAD_REQUEST",
  "title": "Bad request. Check url, params and headers",
  "source": {
    "info": "toDate must be on or after fromDate"
  }
}

통합에서 이 API 사용

일반적인 사용 사례는 다음에서 관리자가 “감사 추적 다운로드” 작업을 진행하는 것입니다.
계정 설정 화면.