Cuando configuras o das soporte a una actividad de Blackboard supervisada con SMOWL, a veces necesitas identificar sin ambigüedad esa actividad concreta: su ID de actividad (Content ID) dentro de Blackboard. Esta guía explica cómo obtenerlo con la API (interfaz de programación de aplicaciones) REST pública de Blackboard Learn.
¿Para qué sirve este ID?
El ID de actividad identifica de forma única un examen o cuestionario dentro de un curso de Blackboard. Te resultará útil para:
Confirmar con el equipo de soporte de Smowltech qué actividad exacta tiene, o debería tener, SMOWL activado, cuando un curso incluye varias actividades con nombres parecidos.
Aportar contexto preciso al abrir un caso de soporte sobre una actividad concreta.
Comprobar que la actividad es del tipo compatible con SMOWL en Blackboard.
Importante: en Blackboard, SMOWL solo puede supervisar exámenes y cuestionarios creados con la herramienta de evaluación nativa de Blackboard (contentHandler: resource/x-bb-asmt-test-link). No es posible supervisar Tareas (Assignments) ni herramientas externas.
Antes de empezar
Necesitas una sesión iniciada en tu instancia de Blackboard (
https://tu-dominio.blackboard.com).Necesitas conocer el curso donde está la actividad que quieres identificar.
No hace falta registrar ninguna aplicación: puedes abrir estos endpoints directamente en el navegador, en la misma pestaña donde tienes la sesión de Blackboard iniciada. Si tu institución añade restricciones de seguridad adicionales, es posible que necesites una integración registrada con OAuth 2.0 (Application Key/Secret); en ese caso, consulta con tu administrador de Blackboard.
Puedes hacer estas consultas con cualquier usuario de Blackboard: administrador, profesor o incluso estudiante. La API respeta siempre los permisos de quien ha iniciado sesión. Un administrador ve cualquier curso; un profesor o un estudiante solo ven los cursos en los que están matriculados. Te recomendamos usar una cuenta de administrador o de profesor del curso para ver toda la información.
Paso 1. Obtén el ID interno del curso
Abre esta URL en tu navegador. Sustituye {tu-dominio} por el de tu instancia de Blackboard y {UUID-del-curso} por el UUID (identificador único universal) del curso:
https://{tu-dominio}.blackboard.com/learn/api/public/v1/courses/uuid:{UUID-del-curso}
La respuesta es un objeto en formato JSON (datos estructurados en texto) con la información del curso. El campo id —con un formato similar a _133_1— es el ID interno del curso que necesitas para el siguiente paso.
¿No tienes el UUID del curso a mano? Blackboard también permite referenciar el curso por su Course ID, el código visible en la configuración del curso dentro de la propia interfaz de Blackboard. Sustituye uuid:{UUID-del-curso} por courseId:{Course-ID-visible-en-Blackboard} en la misma URL.
Ejemplo de respuesta:
Paso 2. Consulta las actividades del curso y localiza el ID
Con el id del curso del paso anterior, abre esta URL:
https://{tu-dominio}.blackboard.com/learn/api/public/v1/courses/uuid:{UUID-del-curso}/contents?recursive=true&contentHandler=resource/x-bb-asmt-test-link
Parámetro | Qué hace |
| Pide a la API que busque también dentro de todas las carpetas y subcarpetas del curso, no solo en su nivel superior. |
| Filtra los resultados para mostrar únicamente los exámenes y cuestionarios nativos de Blackboard: el único tipo de actividad que SMOWL puede supervisar en esta plataforma. |
Cómo leer la respuesta
La respuesta incluye un listado (results) con todas las actividades evaluables del curso. Cada elemento incluye:
id: el ID de actividad que buscas, el identificador único de esa actividad en Blackboard (por ejemplo,_500_1).title: el nombre de la actividad, útil para identificarla visualmente.contentHandler.assessmentId: el identificador de la evaluación asociada. Es distinto del ID de actividad y no es el que necesitas para SMOWL.contentHandler.gradeColumnId: el identificador de la columna de calificaciones vinculada.
Usa siempre el campo id del elemento de contenido, nunca el assessmentId, como ID de actividad al hablar con el equipo de soporte de Smowltech o al configurar la actividad.
Identifica también a un usuario concreto (opcional)
Si necesitas confirmar el identificador interno de un estudiante o de un profesor, por ejemplo para revisar un caso puntual, consulta:
https://{tu-dominio}.blackboard.com/learn/api/public/v1/users/uuid:{UUID-del-usuario}
El campo id de la respuesta es el ID interno de ese usuario en Blackboard. Si consultas este endpoint con un usuario que no es administrador, la información devuelta estará limitada según sus permisos.
¿Qué hago con este ID?
Facilita el ID de actividad, y el ID de curso si aplica, al equipo de soporte de Smowltech al abrir un caso de soporte sobre esa actividad. También te será útil si gestionas los ajustes de SMOWL a través de la API pública de SMOWL o de mySmowltech, donde puedes configurar varias actividades de distintos cursos a la vez.
¿Tienes más dudas? Consulta nuestros artículos relacionados o contacta con nuestro equipo de soporte a través del chat. Puedes abrirlo haciendo clic en el búho situado en la esquina inferior derecha de esta página.