Tipo de recurso educationUser

  • Artículo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Usuario del sistema. Este recurso es una variante específica de educación del recurso de usuario estándar, con el mismo id valor que Microsoft Graph devuelve desde el punto de conexión no específico /users de educación.

Este objeto proporciona un subconjunto de propiedades de destino del objeto de usuario principal y agrega un conjunto de propiedades específicas de educación como primaryRole, studenty teacher.

Métodos

Método Tipo de valor devuelto Descripción
Obtener educationUser educationUser Lea las propiedades y relaciones de un objeto educationUser.
Enumerar clases Colección educationClass Obtenga la colección de objetos educationClass de la que el usuario es miembro.
Enumerar centros educativos Colección educationSchool Obtenga la colección de objetos educationSchool de la que el usuario es miembro.
Obtener usuario user Obtenga el directorio simple user correspondiente a este objeto educationUser.
Actualizar educationUser Actualice un objeto educationUser.
Eliminar Ninguno Elimine un objeto educationUser.
Delta Colección educationUser Obtener cambios incrementales para educationUsers.

Propiedades

Propiedad Tipo Descripción
id String El identificador único del usuario. Heredado de directoryObject. Clave. No admite valores NULL. Solo lectura.
accountEnabled Boolean true si la cuenta está habilitada; en caso contrario, false. Esta propiedad es necesaria cuando se crea un usuario. Es compatible con $filter.
assignedLicenses Colección assignedLicense Las licencias asignadas al usuario. No admite valores NULL.
assignedPlans Colección assignedPlan Los planes asignados al usuario. Solo lectura. No admite valores NULL.
businessPhones Colección string Números de teléfono del usuario. Nota: Aunque se trata de una colección de cadenas, solo se puede establecer un número para esta propiedad.
createdBy identitySet Entidad que ha creado el usuario.
department Cadena El nombre del departamento en el que trabaja el usuario. Es compatible con $filter.
displayName Cadena Nombre del usuario que aparece en la libreta de direcciones. Es compatible con $filter y $orderby.
externalSource Cadena El tipo de origen externo desde el que se generó este recurso (determinado automáticamente a partir de externalSourceDetail). Los valores posibles son sis, lms o manual.
externalSourceDetail Cadena Nombre del origen externo desde el que se generó este recurso.
givenName Cadena El nombre (nombre de pila) del usuario. Es compatible con $filter.
mail Cadena Dirección SMTP para el usuario; por ejemplo, "jeff@contoso.com". Solo lectura. Es compatible con $filter.
mailNickname Cadena El alias de correo del usuario. Esta propiedad debe especificarse al crear un usuario. Es compatible con $filter.
mailingAddress physicalAddress Dirección de correo del usuario. Nota: type y postOfficeBox no se admiten para los educationUser recursos.
middleName String Segundo nombre del usuario.
mobilePhone String El número de teléfono móvil principal del usuario.
onPremisesInfo educationOnPremisesInfo Información adicional que se usa para asociar el usuario Microsoft Entra a su homólogo de Active Directory.
passwordPolicies String Especifica las directivas de contraseña del usuario. Consulte el recurso de usuario estándar para obtener más detalles.
passwordProfile passwordProfile Especifica el perfil de contraseña del usuario. El perfil contiene la contraseña del usuario. Esta propiedad es necesaria cuando se crea un usuario. Consulte el recurso de usuario estándar para obtener más detalles.
preferredLanguage String Idioma preferido del usuario. Debe seguir el código ISO 639-1 (por ejemplo, "en-US").
primaryRole string Rol predeterminado de un usuario. Puede que el rol del usuario sea distinto en una clase individual. Los valores posibles son: student, teacher y faculty. Es compatible con $filter.
provisionedPlans colección provisionedPlan Planes que han sido provisionados para el usuario. Solo lectura. No admite valores NULL.
relatedContacts relatedContact (colección) Registros relacionados con el usuario. Las relaciones posibles son parent, relative, aide, doctor, guardian, child, , , otherunknownFutureValue
residenceAddress physicalAddress Dirección donde reside el usuario. Nota: type y postOfficeBox no se admiten para los educationUser recursos.
student educationStudent Si el rol principal es estudiante, este bloque contiene datos específicos del alumno.
surname Cadena El apellido (o apellidos) del usuario. Es compatible con $filter.
teacher educationTeacher Si el rol principal es profesor, este bloque contendrá datos específicos del profesor.
usageLocation Cadena Un código de país de dos letras (ISO 3166 Alpha-2). Necesario para los usuarios a los que se les asignarán licencias. No admite valores NULL. Es compatible con $filter.
userPrincipalName Cadena Nombre principal de usuario (UPN) para el usuario. Es compatible con $filter y $orderby. Consulte el recurso de usuario estándar para obtener más detalles.
userType Cadena Un valor de cadena puede utilizarse para clasificar los tipos de usuario en el directorio. Por ejemplo: "Miembro" e "Invitado". Es compatible con $filter.

Importante

Cuando se usan ámbitos de permisos delegados, Graph solo devolverá un conjunto limitado de propiedades: id, primaryRole, accountEnabled, displayName, givenName, surname, userTypeuserPrincipalName, onPremisesInfostudent/externalId, teacher/externalId. Si la aplicación requiere propiedades adicionales, debe usar ámbitos de permisos de aplicación.

Relaciones

Relación Tipo Descripción
assignments educationAssignment Lista de asignaciones para el usuario. Admite un valor NULL.
classes Colección educationClass Clases a las que pertenece el usuario. Admite valores NULL.
schools Colección educationSchool Centros educativos a los que pertenece el usuario. Admite valores NULL.
taughtClasses Colección educationClass Clases para las que el usuario es profesor.
Rúbricas colección educationRubric Cuando se establece, la rúbrica de calificación adjunta a la asignación.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "accountEnabled": true,
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "assignedPlans": [{ "@odata.type": "microsoft.graph.assignedPlan" }],
  "businessPhones": ["String"],
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "department": "String",
  "displayName": "String",
  "externalSource": "string",
  "givenName": "String",
  "id": "String (identifier)",
  "mail": "String",
  "mailNickname": "String",
  "mailingAddress": { "@odata.type": "microsoft.graph.physicalAddress" },
  "middleName": "String",
  "mobilePhone": "String",
  "officeLocation": "String",
  "onPremisesInfo": {
    "@odata.type": "microsoft.graph.educationOnPremisesInfo"
  },
  "passwordPolicies": "String",
  "passwordProfile": { "@odata.type": "microsoft.graph.passwordProfile" },
  "preferredLanguage": "String",
  "primaryRole": "string",
  "provisionedPlans": [{ "@odata.type": "microsoft.graph.provisionedPlan" }],
  "residenceAddress": { "@odata.type": "microsoft.graph.physicalAddress" },
  "student": { "@odata.type": "microsoft.graph.educationStudent" },
  "surname": "String",
  "teacher": { "@odata.type": "microsoft.graph.educationTeacher" },
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String"
}