Obtención de información de asignación y calificación para soluciones educativas

Las instituciones educativas tienen herramientas personalizadas que necesitan datos de asignaciones y calificaciones; por ejemplo, herramientas que se usan para la generación de informes y la comunicación con el distrito escolar, o herramientas que se usan para automatizar un conjunto de procesos. Puede usar la API de educación de Microsoft Graph para obtener datos de las asignaciones y calificaciones de clases y alumnos.

Nota: Puede usar el Explorador de Graph para probar las API mencionadas en este artículo.

Obtención de información de clases y miembros

La información de asignación y calificación forma parte del equipo de Microsoft Teams. Puede obtener información sobre clases, miembros y roles (alumno o profesor) en un equipo mediante las siguientes API:

• Enumerar clases de una clase educationSchools: devuelve una lista de todas las clases del inquilino de educación.
• Enumerar miembros de una clase educationClass: Listas información sobre los miembros de una clase específica.

Después de obtener la información de clase y miembro pertinente, puede obtener la información de asignación y calificación que necesita.

Obtener información de asignación de clases

Todas las asignaciones y la información de los alumnos están vinculadas a la información de clase y envío, respectivamente. Puede usar las siguientes API para recuperar información sobre las asignaciones de clases:

• Tipo de recurso educationAssignment: permite enumerar y ver todos los datos de las asignaciones de una clase.
• tipo de recurso educationSubmission: se crea un envío para cada alumno para el que se publica una asignación. Puede usar esta API para obtener el estado de envío, es decir, si se ha entregado y calificado, los recursos enviados por el alumno y la calificación (resultado) del envío.

Obtener información de asignación de alumnos

Un alumno suele estar en varias clases dentro de una escuela, y a menudo necesita ver los datos del alumno entre clases. Puede usar la siguiente API para ver los datos de los alumnos entre clases:

• Enumerar las asignaciones de un usuario: Listas todas las asignaciones de un usuario determinado. Puede usarlo un usuario delegado o la manera preferida es usar appOnly person para usar /users/{user-id}.

Permissions

La API de asignaciones admite los permisos delegados (por usuario) y solo de aplicación (por aplicación). Los permisos de solo aplicación simplifican la experiencia de los alumnos y profesores, ya que solo tienen que aprobar la aplicación para recuperar datos.

Novedades a los datos

En el transcurso del año escolar, habrá actualizaciones de las asignaciones a medida que los profesores y los alumnos continúen trabajando en ellas. Todas las API de educación admiten consultas delta, lo que le permite realizar un seguimiento de los cambios desde la última vez que se consultó el punto de conexión de API.

En el caso de las asignaciones, las consultas delta solo se admiten para los cambios de información de asignación y no para enviar cambios para una asignación.

Filtrado de datos

Los puntos de conexión de api de asignación devuelven una gran cantidad de datos. Puede usar el parámetro de consulta OData de filtro para controlar los datos según sea necesario.

Contenido relacionado

• Introducción a los permisos
• Básicos de autenticación y autorización
• Introducción a la galería de aplicaciones de Microsoft Entra