Table of contents
TOC
Collapse the table of content
Expand the table of content
Última actualización: 25/07/2018

Referencia de la API de REST para profesores

Se aplica a: Office 365 Educación

Esta documentación incluye las características que se encuentran actualmente en la versión preliminar.

Las API de Office 365 Educación ayudan a extraer datos de tu inquilino de Office 365, los cuales han sido sincronizados con la nube con Microsoft School Data Sync. Estos resultados contienen información sobre escuelas, secciones, profesores, estudiantes e información de listas. La API REST para profesores proporciona acceso a entidades de profesores en Office 365 Educación.

La API depende de Microsoft Azure Active Directory y OAuth para autenticar solicitudes de aplicaciones.

Para acceder a la API REST para profesores desde tu aplicación necesitaráregistrarte en Azure Active Directory. También necesitas administrar tokens de autenticación, así como generar la URL y las consultas correctas para satisfacer tus necesidades. Los siguientes ejemplos se pueden usar para ayudar en la elaboración de tus consultas.

Probar las API

Todas las API de listas de participante de escuelas pueden probarse en una cuenta empresarial EDU usando el Probador de Graph. Navega en el Probador de Graph, inicia sesión con tus credenciales de cuenta empresarial O365 EDU, selecciona 'beta' como versión, copia/pega las URL y verifica la respuesta.

Todas las operaciones de la API REST para profesores

Los profesores se presentan como Usuarios en Azure Active Directory. Puedes obtener los atributos de los profesores actuales que están conectados, así como la escuela y las secciones de las que cada profesor es miembro.

Obtener el usuario actual | Obtener la escuela de un profesor | Obtener la sección de un profesor

Utilizar la API de REST para profesores

Para interactuar con la API REST de Profesores, debes enviar solicitudes HTTP GET.

Si el usuario que ha iniciado sesión es un profesor, todas las solicitudes de la API REST de profesores utilizan la siguiente URL raíz:

https://graph.microsoft.com/beta/me/

Los profesores se muestran en Azure Active Directory como usuarios. Los atributos de extensión de los usuarios agregan información específica del profesor.
Por ejemplo, el atributo extension_fe2174665583431c953114ff7268b7b3_Education_TeacherNumber contiene el número de profesor del profesor.

Atributos del profesor

La descripción de los atributos que ayudan a identificar la información sobre el Profesor se encuentran en: Atributos del profesor


Obtener el usuario actual

Puedes obtener el usuario actualmente conectado y comprobar si ese usuario es un profesor.

GET https://graph.microsoft.com/beta/me/

Tipo de respuesta

El usuario registrado actualmente.

Verificar si es profesor

Un usuario actualmente conectado puede ser un estudiante, un profesor o un usuario no docente (por ejemplo, personal administrativo). Puedes verificar si el usuario es un profesor desde tu aplicación. Buscar el atributo de extensión Education_ObjectType para igualar Teacher.

extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'Teacher'

Obtener la escuela de un profesor

Las escuelas se muestran en Azure Active Directory como Unidades administrativas. Los atributos de extensión en estas unidades administrativas agregan información específica sobre la escuela. Por ejemplo, el atributo extension_fe2174665583431c953114ff7268b7b3_Education_HighestGrade contiene la calificación más alta para esa escuela.

Puedes acceder a la escuela del profesor conectado obteniendo la pertenencia de ese profesor y, tras ello, filtrando por extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'School' y objectType == 'AdministrativeUnit'

Obtener pertenencia del profesor

Puedes obtener la pertenencia del profesor conectado utilizando la siguiente consulta.

GET https://graph.microsoft.com/beta/me/

Tipo de respuesta

La respuesta incluirá múltiples Grupos, Roles de Directorio y/o Unidades Administrativas de los que el profesor es miembro.

Filtrar por escuela

Puedes obtener la escuela de un profesor filtrando en extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'School' y objectType == 'AdministrativeUnit'.


Obtener la sección de un profesor

Las secciones se muestran en Azure Active Directory como Grupos unificados. Los atributos de extensión en los grupos unificados agregan información específica sobre la sección. Por ejemplo, el atributo extension_fe2174665583431c953114ff7268b7b3_Education_CourseName contiene el nombre del curso para la sección.

Obtener pertenencia del profesor

Puedes obtener la pertenencia del profesor utilizando la siguiente consulta.

GET https://graph.microsoft.com/beta/me/

Tipo de respuesta

La respuesta incluirá múltiples Grupos, Roles de Directorio y/o Unidades Administrativas de los que el profesor es miembro.

Filtrar por sección

Puedes obtener la sección de un profesor filtrando en extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType == 'Section' y objectType == 'Group'.


Pasos siguientes

Otros recursos educativos similares en los que podrías estar interesado

Tanto si ya estás preparado para comenzar a desarrollar una aplicación o si tan solo deseas obtener más información, tenemos todo lo que necesitas.

O bien, obtén más información sobre el uso de la plataforma Office 365:

© 2018 Microsoft