Tipo de recurso educationUser

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.

Representa a un usuario en el sistema. Este recurso es una variante específica del recurso de usuario estándar específico para el sector educativo, con el mismo id nivel que Microsoft Graph devuelve desde el punto de conexión no específico /users para el ámbito educativo.

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

Métodos

Método Tipo de valor devuelto Descripción
Obtener usuario 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 usuario Ninguno Elimine un objeto educationUser.
Obtener delta Colección educationUser Obtenga 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 El 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 La dirección SMTP del 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 son compatibles con educationUser los recursos.
middleName String Segundo nombre del usuario.
mobilePhone String El número de teléfono móvil principal del usuario.
officeLocation String La ubicación de la oficina para el usuario.
onPremisesInfo educationOnPremisesInfo Información adicional usada para asociar el usuario de Microsoft Entra con su homólogo de Active Directory.
passwordPolicies String Especifica las directivas de contraseña del usuario. Para obtener más información, consulte el recurso de usuario estándar.
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. Para obtener más información, consulte el recurso de usuario estándar.
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, faculty. Es compatible con $filter.
provisionedPlans colección provisionedPlan Planes que han sido provisionados para el usuario. Solo lectura. No admite valores NULL.
contactos relacionados relacionadoRecopilación de contactos Registros relacionados relacionados con el usuario. Las relaciones posibles son parent, relative, aide, doctor, guardianchild, , other,unknownFutureValue
residenceAddress physicalAddress Dirección donde reside el usuario. Nota: type y postOfficeBox no son compatibles con educationUser los recursos.
student educationStudent Si el rol principal es alumno, 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 contiene 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 asignan licencias. No admite valores NULL. Es compatible con $filter.
userPrincipalName Cadena El nombre principal de usuario (UPN) del usuario. Es compatible con $filter y $orderby. Para obtener más información, consulte el recurso de usuario estándar.
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, userPrincipalNamedisplayNamesurnameteacher/externalIdgivenNameuserTypeonPremisesInfostudent/externalId, . Si su 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 valores 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úbrica educationRubric collection Cuando se establece, el criterio de evaluación se adjunta a la tarea.

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"
}
  • Se actualizó por última vez el