Cambios en la API de la versión de abril de 2026

La versión de abril de 2026 de Adobe Learning Manager introduce mejoras específicas en la API pública en torno a alternativas y equivalentes, acceso al contenido con ventana de tiempo, intentos de cuestionario basados en contenido, experiencias sin inicio de sesión y gestión de ayudas de trabajo. Los cambios están diseñados para ser en gran medida compatibles con versiones anteriores, al tiempo que permiten integraciones más precisas.

Aprendizaje adaptable para rutas de aprendizaje

Esta versión añade compatibilidad total con la API pública para rutas de aprendizaje adaptables. Las rutas de aprendizaje (LP) ahora pueden definir reglas adaptables que controlan qué secciones y objetos de subaprendizaje (subobjetos de aprendizaje) son visibles para los diferentes grupos de alumnos, y la API pública refleja este comportamiento.

Se ven afectados los siguientes puntos finales:

Un nuevo atributo booleano, attributes.isAdaptive, indica que un programa de aprendizaje utiliza reglas adaptables. Cuando este indicador es true, el atributo sections se interpreta de forma adaptativa.

Para las llamadas de alumnos, solo se devuelven las secciones visibles para el alumno actual. Cada sección incluye la lista de ID de objeto de aprendizaje (loIds), un indicador obligatorio y un LOCount obligatorio que se calculan según la configuración adaptable de ese alumno, así como el sectionId. La relación relations.subLOs ahora también se filtra, por lo que solo contiene los objetos de subaprendizaje que son visibles para ese alumno.

Para las llamadas de administrador, las secciones también pueden exponer una matriz adaptiveConfig. Se describen las reglas adaptables por grupo de usuarios, incluidos userGroupId y userGroupName, y si la sección es obligatoria para ese grupo. Las herramientas orientadas a los administradores pueden utilizar esta opción para visualizar y gestionar reglas adaptables.

Restablecer finalización para programas de aprendizaje

La versión introduce una API para actualizar (restablecer) la finalización de los objetos de aprendizaje, incluidos los programas de aprendizaje adaptables. Esto es compatible con situaciones como el reciclaje, actualizaciones periódicas de cumplimiento o reinicios de programas.

Hay un nuevo punto final disponible:

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

Esta operación requiere los permisos de escritura adecuados y restablece el estado de finalización de la instancia de objeto de aprendizaje especificada en el contexto de usuario especificado. Está pensada para su uso por parte de automatizaciones del lado de los administradores o herramientas de aprendizaje con un ámbito cuidado.

Una versión en bloque de esta capacidad está planificada mediante una API de trabajos. La forma de solicitud está diseñada para dirigirse a los usuarios por correo electrónico, ID de usuario o ID de grupo de usuarios, por ejemplo:

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

Las integraciones deben utilizar esta API cuando necesiten reiniciar a los alumnos en cada programa o curso. Los clientes deben gestionar correctamente las respuestas a los errores: la API puede rechazar las solicitudes de actualización, donde no es aplicable un restablecimiento (por ejemplo, cuando no existe finalización o no se admiten los tipos de objetos de aprendizaje).

Equivalentes y finalizaciones alternativas

Para admitir implementaciones en las que varios objetos de aprendizaje pueden cumplir el mismo requisito, la versión introduce finalizaciones de equivalentes y alternativas como API públicas.

Los puntos finales del objeto de aprendizaje ahora contienen esta información:

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

Un nuevo atributo booleano attributes.isAlternateComplete indica si la finalización del alumno para un objeto de aprendizaje determinado es el resultado de un objeto de aprendizaje alternativo o equivalente en lugar del propio objeto. Cuando esto es cierto, la relación relations.alternativeCompltions enumera los objetos de aprendizaje que actuaron como alternativos. Esto permite que los informes descendentes y los paneles distingan entre finalizaciones directas y alternativas y muestren qué alternativas cumplen el requisito.

Además, una vista relacionada de objetos de aprendizaje permite descubrir alternativas potenciales que pueden satisfacer a un objeto de aprendizaje. Esto se expone a través de:

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

La respuesta devuelve objetos de aprendizaje que pueden actuar como alternativas e incluye un campo meta.count que indica el número total de dichas alternativas, independientemente del límite actual. Las integraciones pueden utilizar esto para presentar equivalentes recomendados o para generar vistas administrativas de asignaciones alternativas.

Informes y casos prácticos de análisis

Los usuarios que generen informes o análisis deben actualizar su lógica para añadir isAlternateComplete y alternativeCompltions a sus flujos de trabajo de informes.

Las integraciones de informes que consumen datos de finalización (por ejemplo, exportación de LT, fuentes de almacén de datos personalizadas o paneles de BI) deben ampliar su lógica para leer y conservar tanto attributes.isAlternateComplete como relations.alternativeCompltions de las API de LO:

Casos de uso típicos:

Sin incorporar estos dos campos, los informes descendentes tratarán las finalizaciones alternativas como finalizaciones regulares y no podrán explicar por qué un alumno muestra como completado un curso de formación que nunca realizó directamente.

Comportamiento del alumno frente a la API del objeto de aprendizaje administrador

La estructura de ayudas de trabajo en varios idiomas es idéntica en las API de objetos de aprendizaje y de administrador. El ámbito del alumno devuelve solo las ayudas de trabajo visibles para el alumno, pero para cada ayuda de trabajo visible expone todas las configuraciones regionales configuradas a través de varias entidades de recursos (una por configuración regional) y metadatos localizados en varias configuraciones regionales. El ámbito de administración devuelve todas las ayudas de trabajo que el administrador puede administrar, con el mismo modelo de objeto de aprendizaje e ID de recurso específicos de la configuración regional. Los clientes con ámbito de alumno deben elegir el recurso cuyos atributos.locale coincidan mejor con el idioma de contenido del alumno, mientras que las herramientas de administración pueden enumerar todas las configuraciones regionales para la creación de informes y la administración.

Lista de comprobación con capacidad de comentarios

Para admitir flujos de trabajo en los que los revisores pueden compartir comentarios estructurados sobre actividades basadas en listas de comprobación, esta versión muestra comentarios de listas de comprobación y controles de visibilidad de revisores a través de la API de recursos de objetos de aprendizaje.

Los metadatos relacionados con la lista de comprobación se muestran en entidades learningObjectResource (JApiLOResource, "type": "learningObjectResource") que representan recursos de la lista de comprobación dentro de un curso u otro objeto de aprendizaje.

La información está disponible a través de:

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

Cuando la instancia del objeto de aprendizaje contiene recursos de tipo lista de comprobación, las entradas learningObjectResource correspondientes de la matriz incluida exponen los atributos de comentario y visibilidad del revisor en atributos, y la identidad del revisor en relaciones.

Nuevos atributos de comentario de lista de comprobación

Para los recursos de la lista de comprobación, pueden estar presentes los siguientes atributos en learningObjectResource:

Otros contextos específicos de la lista de comprobación, como checklistEvaluationStatus, isChecklistObligatorio, resourceSubType: "CHECKLIST" y submitDate también están disponibles en el mismo learningObjectResource para admitir más interfaces de usuario e informes de listas de comprobación.

Relación de identidad del revisor

Cuando los nombres de los revisores están pensados para ser visibles, learningObjectResource incluye una relación que señala al usuario del revisor:

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

Esta relación se rellena solo si:

Las aplicaciones cliente deben:

Acceso a recursos y comentarios de lista de comprobación

Para recuperar los recursos de la lista de comprobación y sus comentarios para un objeto de aprendizaje determinado, los clientes deben:

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

Este modelo permite a los clientes descentralizados o personalizados procesar una experiencia de lista de comprobación completa, que incluye el estado, los indicadores obligatorios/opcionales y los comentarios de los revisores, directamente desde las API de Captivate Prime.

Consideraciones sobre informes y experiencia de usuario

Compatibilidad con varios idiomas para la ayuda de trabajo

Para admitir implementaciones en las que las ayudas de trabajo deben entregarse en varios idiomas tanto a los alumnos como a los administradores, esta versión amplía el control de las ayudas de trabajo para devolver un recurso por configuración regional en lugar de un único recurso en-US codificado de forma rígida.

Las ayudas de trabajo en varios idiomas siguen utilizando la jerarquía existente:

objeto de aprendizaje (lo) → recursoObjetoDeAprendizaje (recursoLo) → recurso

No se requieren cambios en el contrato de la API. Cualquier ayuda de trabajo localizada se ajusta de forma natural a esta estructura, con entidades de recursos independientes por configuración regional y metadatos localizados compartidos en los niveles learningObject/learningObjectResource.

Los datos de la ayuda de trabajo se exponen mediante:

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

Cuando una ayuda de trabajo tiene varias variantes de idioma, la matriz incluida contiene varias entradas "tipo": "recurso", una para cada configuración regional (por ejemplo, en-US, fr-FR, es-ES), todas vinculadas desde un único recurso learningObjectResource.

Estructura de ayudas de trabajo en varios idiomas

Las ayudas de trabajo en varios idiomas utilizan:

Para una ayuda de trabajo en varios idiomas, un patrón típico es:

Los clientes pueden seleccionar el recurso adecuado haciendo coincidir la configuración regional del alumno con el campo resource.attributes.locale.

Nuevo formato de Id. de recurso para ayudas de trabajo

Para distinguir correctamente varias variantes localizadas de un recurso de ayuda de trabajo, el formato de identificador de recurso ha cambiado.

Formato de id. de recurso antiguo (heredado)

Anteriormente, los recursos de ayudas de trabajo utilizaban un formato de ID opaco, como:

jobAid:131032_-1_-1_2_resource

Este formato no codificaba la configuración regional, y las API mostraban de forma efectiva solo un recurso (normalmente en-US).

Nuevo formato de Id. de recurso (compatible con varios idiomas)

El nuevo formato es:

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

Ejemplos:

Desglose visual:

jobAid:131032_2_fr_FR

        │      │ │ │

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

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

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

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

Esta estructura permite a los clientes:

Retrocompatibilidad:

/resources/{resourceId}

El extremo de recurso heredado sigue estando disponible:

Ahora es compatible con versiones anteriores con los formatos de ID nuevo y antiguo:

Las integraciones que actualmente almacenan o hacen referencia a los identificadores de recursos antiguos pueden seguir funcionando sin cambios, mientras que se recomienda a las implementaciones más recientes que adopten el nuevo formato de identificador para las operaciones específicas de la configuración regional.

Consideraciones sobre integración y experiencia de usuario

Restricciones de espacio de tiempo para módulos de inicio

Algunas experiencias de aprendizaje deben estar disponibles solo dentro de un intervalo de tiempo definido. La versión muestra información de intervalos de tiempo sobre los recursos de objetos de aprendizaje e introduce un punto final de validación que comprueba si un alumno puede iniciar un recurso en el tiempo actual.

Los metadatos de franja horaria están disponibles a través del punto final:

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

En el nivel de recurso del objeto de aprendizaje, ahora puede haber un objeto timeSlot presente en los atributos, con valores startTime y endTime en UTC. Esto especifica la ventana durante la cual se puede iniciar el recurso.

Antes de iniciar un módulo, las integraciones pueden llamar a un nuevo punto final de validación:

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

Este punto final, diseñado para escenarios de lectura del alumno, devuelve si el alumno puede iniciar el recurso en ese momento, teniendo en cuenta el intervalo de tiempo configurado, el tipo de entrega y otras reglas de back-end.

Los reproductores personalizados y las aplicaciones cliente deben utilizar canStart para exigir el acceso basado en el tiempo y utilizar los metadatos timeSlot para mostrar mensajes claros sobre cuándo el contenido está disponible o caduca. Las respuestas negativas de canStart se deben controlar explícitamente para informar a los alumnos de por qué el contenido no se puede iniciar todavía o ya.

Cuestionarios de varios intentos basados en el contenido

Algunos paquetes de contenido implementan su propio seguimiento de intentos en lugar de depender únicamente de Adobe Learning Manager. La versión introduce un indicador que indica cuándo los intentos los controla el propio contenido.

Mediante:

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

Los recursos de objetos de aprendizaje ahora pueden exponer un atributo booleano hasContentDrivenAttemptTracking. Cuando esto es cierto, el cuestionario o módulo gestiona los intentos internamente (por ejemplo, a través de la lógica SCORM o xAPI), y es posible que los contadores de intentos estándar de la plataforma no reflejen completamente la experiencia del alumno.

Las integraciones que muestren recuentos de intentos o controlen el comportamiento de reintentos deben comprobar este indicador. Cuando está activada, no deben inferir los límites de intentos únicamente a partir de los metadatos de la plataforma y deben estar preparados para basarse en informes del lado del contenido (por ejemplo, a través de declaraciones xAPI) o reglas específicas de la empresa.

Cambio de comportamiento en el formato de ID de recurso de ayuda de trabajo

Esta versión introduce un cambio de comportamiento importante en el formato de los identificadores de recursos de la ayuda de trabajo. Si bien no hay ningún punto final nuevo involucrado, esto tiene un impacto directo en los sistemas que almacenan o analizan estos ID.

Anteriormente, los identificadores de recursos de ayuda de trabajo utilizaban un formato como:

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

En la versión de abril de 2026, se ha sustituido por un formato simplificado y más explícito:

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

Por ejemplo:

jobAid:131032_2_fr_FR

Los componentes son:

Cualquier integración que indexe recursos o persista en ID de recursos de ayuda de trabajo debe actualizar su lógica de análisis y almacenamiento para reconocer el nuevo formato. Dado que los identificadores en sí cambian, se recomienda encarecidamente que vuelva a generar los índices locales definidos por los identificadores de recursos de ayuda de trabajo después de actualizar a la versión de abril de 2026.

Definir imágenes de banners de cursos mediante la migración

Ahora puede definir o actualizar las imágenes de los banners del curso en Adobe Learning Manager como parte del flujo de trabajo de migración estándar. Esto le ayuda a iniciar o limpiar catálogos grandes mientras mantiene las páginas del curso visualmente coherentes, sin necesidad de editarlas manualmente

Dónde se definen las imágenes del banner

Las imágenes de banner se configuran en el archivo de migración course.csv, que ya se utiliza para proporcionar metadatos del curso, como:

Con esta mejora, la especificación course.csv incluye una columna opcional adicional para la imagen del banner del curso. El nombre exacto del encabezado se define en la especificación CSV que se descarga de la cuenta de Learning Manager (por ejemplo, puede aparecer como bannerUrl o bannerImageUrl).

La columna del titular:

Preparación de imágenes de banner para la migración

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

Aplicar banners durante una ejecución de migración

Una vez actualizado course.csv, el flujo es el mismo que para cualquier otra migración:

Cursos nuevos frente a cursos existentes

El campo de titular funciona en ambos casos:

Los nombres de columna y las rutas de acceso reales deben coincidir con la especificación CSV descargada y el diseño del repositorio de contenido.

Quitar columna de orden en LearningProgramCourse

Adobe Learning Manager ahora admite un modelo simplificado para ordenar cursos dentro de rutas de aprendizaje (programas de aprendizaje) durante la migración. Como parte de este cambio, la columna order se elimina del archivo de migración learning_program_course.csv.

Anteriormente, el archivo learning_program_course.csv incluía una columna (a menudo denominada order o similar) que se utilizaba para:

Ahora, Adobe Learning Manager ya no utiliza la columna de orden en learning_program_course.csv para determinar el orden del curso. En su lugar, el archivo CSV de migración se centra en qué cursos pertenecen a cada programa de aprendizaje, en lugar de en cómo se ordenan numéricamente.

Incidencia en los archivos CSV de migración

learning_program_course.csv

Debe tratar la columna de orden heredada como eliminada u omitida:

Consulta siempre las especificaciones de CSV más recientes de tu cuenta de Learning Manager (mediante csv_specifications.zip) para confirmar el conjunto de encabezados y los requisitos actuales.

timeZoneCode en instancias del curso

A partir de esta versión, el modelo Instancia del curso (learningObjectInstance) muestra un nuevo atributo:

timeZoneCode: un campo de cadena que vincula explícitamente una instancia de curso a una de las zonas horarias configuradas de la cuenta.

Esto permite a los clientes:

Donde aparece timeZoneCode

El campo se añade en los atributos del modelo learningObjectInstance
solo para instancias de curso.

Ejemplo:

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

Cómo resolver timeZoneCode

El valor numérico de timeZoneCode es una clave de búsqueda en el catálogo de zonas horarias de la cuenta, que se muestra mediante la API de la cuenta:

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

Dentro de la respuesta, las zonas horarias se enumeran en:

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

Flujo de cliente recomendado:

API públicas asíncronas para la suscripción de grupos de usuarios

Introducción

Adobe Learning Manager expone dos API asincrónicas de administración para administrar la pertenencia a grupos de usuarios (UG):

En lugar de actualizar la suscripción en la misma solicitud, estas API aceptan el lote y devuelven un ID de evento. El resultado real se entrega más tarde a través de webhooks.

Utilícelos cuando:

Para las acciones de administración pequeñas e interactivas, puede seguir utilizando las API sincrónicas de /userGroups/{id}/users.

Autenticación y URL base

Estas API forman parte de la superficie estándar v2 Admin API.

Para conocer el comportamiento y los ámbitos generales de la API de administración, consulte:

Formato de solicitud

Tanto add como remove usan exactamente la misma forma de cuerpo.

Cuerpo

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

datos (obligatorio)

datos es la lista de identificadores de recursos de usuario para este lote.

Restricciones

Si se produce un error en cualquiera de estas condiciones, la API devolverá un error y no se pondrá nada en cola.

metadatos (opcional)

metadata es cualquier dato de correlación adicional que desee reproducir en el webhook.

Uso típico:

El servicio devuelve este objeto sin cambios en la respuesta Webhook, de modo que puede hacer coincidir la devolución de llamada con su trabajo interno.

Restricciones:

Formato de respuesta

Ambos puntos finales responden de forma sincrónica con un ID de evento:

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

Comportamiento:

Siempre debes:

Vea Webhooks para agregar y quitar miembros de grupos de usuarios para obtener más información.

Preguntas frecuentes

¿Cómo cambia la versión de abril de 2026 la API learningObjects para programas de aprendizaje adaptables?

Esta versión añade un indicador isAdaptive en los programas de aprendizaje y proporciona a las secciones y subobjetos información sobre el alumno. En los programas adaptativos, los alumnos solo ven las secciones y los objetos de subaprendizaje que son visibles para ellos en función de las reglas adaptativas, mientras que los administradores pueden ver la configuración adaptativa subyacente de un grupo de usuarios.

¿Tengo que actualizar mi integración si se supone que siempre se devuelven todas las secciones y subobjetos de aprendizaje?

Sí. Para los programas de aprendizaje adaptables, la API ahora devuelve solo las secciones y los subobjetos de aprendizaje que son visibles para el alumno actual. El código de cliente debe tratar la respuesta como la vista autorizada y posiblemente filtrada, en lugar de suponer una lista completa.

¿Cómo puedo restablecer mediante programación la finalización de un alumno para un curso o programa de aprendizaje?

Utilice el nuevo punto final:

POST /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/refreshCompletion
Esto restablece la finalización de la instancia de destino cuando los permisos y el estado lo permiten.

¿Cómo puedo saber si un alumno ha completado algo a través de un objeto de aprendizaje alternativo o equivalente?

Compruebe el atributo isAlternateComplete en el objeto de aprendizaje. Si es verdadero, la relación alternativeCompltions muestra los objetos de aprendizaje que actuaron como alternativas para la finalización de ese alumno.

¿Cómo puedo encontrar todas las alternativas que puedan satisfacer un objeto de aprendizaje en particular?

Utilice el siguiente punto final:

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

y utilice la matriz de datos (para las alternativas) y meta.count (para el número total de alternativas).

¿Cómo sé si un alumno puede iniciar un módulo en este momento?

En primer lugar, busque el timeSlot del recurso de:

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources
y luego use:

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

¿Qué significa ContentDrivenAttemptTracking en un recurso?

Indica que el seguimiento de intentos está controlado por el propio contenido (por ejemplo, a través de la lógica SCORM/xAPI) en lugar de solo por los contadores de la plataforma. Cuando sea cierto, no confíes únicamente en los recuentos o límites de intentos de plataforma para tu experiencia de usuario e informes.

¿Cómo puedo obtener menús apropiados para usuarios que no han iniciado sesión (experiencias públicas)?

Uso:

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

Esto devuelve estructuras de menú y página filtradas para usuarios anónimos, adecuadas para Experience Builder u otros sitios sin encabezado.

¿Qué ha cambiado en el filtrado de ayudas de trabajo con effectiveModifiedDate?

Las solicitudes que combinan filter.effectiveModifiedDate con filter.loTypes=jobAid ahora devuelven correctamente solo las ayudas de trabajo dentro de la ventana de fecha especificada.

¿Qué ha cambiado en el formato de ID de recurso de ayuda de trabajo y cómo debo gestionarlo?

El formato de ID ha cambiado de valores como:

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

para:

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

por ejemplo jobAid:131032_2_fr_FR. Cualquier sistema que almacene o analice identificadores de recursos de ayuda de trabajo debe actualizarse y debe planear la reconstrucción de los índices locales marcados por estos identificadores después de actualizar a la versión de abril de 2026.