Tipo de recurso educationUsereducationUser resource type

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Usuario del sistema.A user in the system. Se trata de una variante específica del ámbito educativo del usuario con el mismo id que devolverá Microsoft Graph desde el punto de conexión /users no específico del ámbito educativo.This is an education-specific variant of the user with the same id that Microsoft Graph will return from the non-education-specific /users endpoint. Este objeto ofrece un subconjunto de destino de propiedades del objeto user principal y agrega un conjunto de propiedades específicas del ámbito educativo tales como primaryRole, alumno y datos de profeso.This object provides a targeted subset of properties from the core user object and adds a set of education-specific properties such as primaryRole, student, and teacher data.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescriptionDescription
Obtener educationUserGet educationUser educationUsereducationUser Lea las propiedades y relaciones de un objeto educationUser.Read properties and relationships of an educationUser object.
Enumerar clasesList classes Colección educationClasseducationClass collection Obtenga la colección de objetos educationClass de la que el usuario es miembro.Get the educationClass object collection for which the user is member.
Enumerar centros educativosList schools Colección educationSchooleducationSchool collection Obtenga la colección de objetos educationSchool de la que el usuario es miembro.Get the educationSchool object collection for which the user is a member.
Obtener usuarioGet user usuariouser Obtenga el directorio simple user correspondiente a este objeto educationUser.Get the simple directory user that corresponds to this educationUser.
ActualizarUpdate educationUsereducationUser Actualice un objeto educationUser.Update an educationUser object.
EliminarDelete NingunoNone Elimine un objeto educationUser.Delete an educationUser object.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
accountEnabledaccountEnabled BooleanoBoolean true si la cuenta está habilitada; en caso contrario, false.True if the account is enabled; otherwise, false. Esta propiedad es necesaria cuando se crea un usuario.This property is required when a user is created. Es compatible con $filter.Supports $filter.
assignedLicensesassignedLicenses Colección assignedLicenseassignedLicense collection Las licencias asignadas al usuario. No admite valores NULL.The licenses that are assigned to the user. Not nullable.
assignedPlansassignedPlans Colección assignedPlanassignedPlan collection Los planes asignados al usuario. Solo lectura. No admite valores NULL.The plans that are assigned to the user. Read-only. Not nullable.
businessPhonesbusinessPhones Colección stringString collection Números de teléfono del usuario.The telephone numbers for the user. Nota: Aunque se trata de una colección de cadenas, solo se puede establecer un número para esta propiedad.Note: Although this is a string collection, only one number can be set for this property.
createdBycreatedBy identitySetidentitySet Entidad que ha creado el usuario.Entity who created the user.
departmentdepartment StringString El nombre del departamento en el que trabaja el usuario. Es compatible con $filter.The name for the department in which the user works. Supports $filter.
displayNamedisplayName StringString Nombre del usuario que aparece en la libreta de direcciones.The name displayed in the address book for the user. Suele ser la combinación del nombre del usuario, la inicial del segundo nombre y el apellido.This is usually the combination of the user's first name, middle initial, and last name. Esta propiedad es necesaria al crearse un usuario y no puede borrarse durante las actualizaciones.This property is required when a user is created and it cannot be cleared during updates. Es compatible con $filter y $orderby.Supports $filter and $orderby.
externalSourceexternalSource educationExternalSource Indica desde dónde se ha creado este usuario.Where this user was created from. Los valores posibles son: sis , manual .The possible values are: sis, manual.
givenNamegivenName StringString El nombre (nombre de pila) del usuario. Es compatible con $filter.The given name (first name) of the user. Supports $filter.
idid StringString El identificador único del usuario. Heredado de directoryObject. Clave. No admite valores NULL. Solo lectura.The unique identifier for the user. Inherited from directoryObject. Key. Not nullable. Read-only.
mailmail StringString Dirección SMTP del usuario (por ejemplo: "jeff@contoso.onmicrosoft.com").The SMTP address for the user; for example, "jeff@contoso.onmicrosoft.com". Solo lectura.Read-Only. Es compatible con $filter.Supports $filter.
mailingAddressmailingAddress physicalAddressphysicalAddress Dirección de correo del usuario.Mail address of user.
mailNicknamemailNickname StringString El alias de correo del usuario. Esta propiedad debe especificarse al crear un usuario. Es compatible con $filter.The mail alias for the user. This property must be specified when a user is created. Supports $filter.
middleNamemiddleName StringString Segundo nombre del usuario.The middle name of user.
mobilePhonemobilePhone StringString El número de teléfono móvil principal del usuario.The primary cellular telephone number for the user.
passwordPoliciespasswordPolicies StringString Especifica las directivas de contraseña del usuario.Specifies password policies for the user. Este valor es una enumeración con un valor posible de "DisableStrongPassword", que permite especificar contraseñas más seguras que la directiva predeterminada.This value is an enumeration with one possible value being "DisableStrongPassword", which allows weaker passwords than the default policy to be specified. También se puede especificar "DisablePasswordExpiration"."DisablePasswordExpiration" can also be specified. Pueden especificarse los dos juntos; (por ejemplo: "DisablePasswordExpiration, DisableStrongPassword").The two can be specified together; for example: "DisablePasswordExpiration, DisableStrongPassword".
passwordProfilepasswordProfile PasswordProfilePasswordProfile Especifica el perfil de contraseña del usuario.Specifies the password profile for the user. El perfil contiene la contraseña del usuario.The profile contains the user's password. Esta propiedad es necesaria cuando se crea un usuario.This property is required when a user is created. La contraseña del perfil debe cumplir los requisitos mínimos especificados por la propiedad passwordPolicies.The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. De manera predeterminada, se requiere una contraseña segura.By default, a strong password is required.
preferredLanguagepreferredLanguage StringString Idioma preferido del usuario.The preferred language for the user. Debe seguir el código ISO 639-1 (por ejemplo, "en-US").Should follow ISO 639-1 Code; for example, "en-US".
primaryRoleprimaryRole educationUserRoleeducationUserRole Rol predeterminado de un usuario.Default role for a user. Puede que el rol del usuario sea distinto en una clase individual.The user's role might be different in an individual class. Los valores posibles son: student , teacher .The possible values are: student, teacher. Es compatible con $filter.Supports $filter.
provisionedPlansprovisionedPlans Colección ProvisionedPlanProvisionedPlan collection Los planes que se ha aprovisionado para el usuario. Solo lectura. No admite valores NULL.The plans that are provisioned for the user. Read-only. Not nullable.
relatedContactsrelatedContacts colección relatedContactrelatedContact collection Conjunto de contactos relacionados con el usuario.Set of contacts related to the user. Esta propiedad opcional debe especificarse en una cláusula $select y solo puede recuperarse para un usuario individual.This optional property must be specified in a $select clause and can only be retrieved for an individual user.
residenceAddressresidenceAddress physicalAddressphysicalAddress Dirección donde reside el usuario.Address where user lives.
studentstudent educationStudenteducationStudent Si el rol principal es alumno, este bloque contendrá datos específicos de alumnos.If the primary role is student, this block will contain student specific data.
surnamesurname StringString El apellido (o apellidos) del usuario. Es compatible con $filter.The user's surname (family name or last name). Supports $filter.
teacherteacher educationTeachereducationTeacher Si el rol principal es profesor, este bloque contendrá datos específicos del profesor.If the primary role is teacher, this block will contain teacher specific data.
usageLocationusageLocation StringString Código de país de dos letras (norma ISO 3166).A two-letter country code (ISO standard 3166). Es necesario para los usuarios a quienes se van a asignar licencias debido a un requisito legal de comprobación de disponibilidad en los países o las regiones.Required for users who will be assigned licenses due to a legal requirement to check for availability of services in countries or regions. Estos son algunos ejemplos: "US", "JP" y "GB".Examples include: "US", "JP", and "GB". No admite valores NULL.Not nullable. Es compatible con $filter.Supports $filter.
userPrincipalNameuserPrincipalName StringString El nombre principal del usuario (UPN) del usuario.The user principal name (UPN) of the user. El UPN es un nombre de inicio de sesión de Internet del usuario basado en la norma RFC 822.The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. Por convención, se debe asignar al nombre de correo electrónico del usuario.By convention, this should map to the user's email name. El formato general es alias@domain, donde el dominio debe estar presente en la colección de dominios comprobados del espacio empresarial.The general format is alias@domain, where domain must be present in the tenant's collection of verified domains. Esta propiedad es necesaria cuando se crea un usuario.This property is required when a user is created. Se puede acceder a los dominios verificados del inquilino desde la propiedad verifiedDomains en organización.The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Es compatible con $filter y $orderby.Supports $filter and $orderby.
userTypeuserType CadenaString Un valor de cadena que puede utilizarse para clasificar los tipos de usuario en el directorio. Por ejemplo: "Miembro" e "Invitado". Es compatible con $filter.A string value that can be used to classify user types in your directory, such as "Member" and "Guest". Supports $filter.

RelacionesRelationships

RelaciónRelationship TipoType DescriptionDescription
classesclasses Colección educationClasseducationClass collection Clases a las que pertenece el usuario.Classes to which the user belongs. Admite valores NULL.Nullable.
schoolsschools Colección educationSchooleducationSchool collection Centros educativos a los que pertenece el usuario.Schools to which the user belongs. Admite valores NULL.Nullable.
assignmentsassignments educationAssignmenteducationAssignment Lista de tareas del usuario.List of assignments for the user. Admite un valor NULL.Nullable.
usuariouser usuariouser El usuario de directorio correspondiente a este usuario.The directory user corresponding to this user.

Importante

El recurso educationAssignment es un recurso de versión/beta.The educationAssignment resource is a /beta version resource. Si usa este recurso, asegúrese de revisar periódicamente el registro de cambios.If using this resource, be sure to review the change log periodically. Cuando los recursos de la API de Microsoft Graph se publican en el extremo/v1.0, la versión se indica en el registro de cambios.When Microsoft Graph API resources are released to the /v1.0 endpoint, the release is noted in the change log. Si la aplicación usa el recurso educationAssignment , deberá declarar las direcciones URL de la solicitud base como se muestra en el siguiente bloque de código:If your app consumes the educationAssignment resource, you will need to declare base request URLs as shown in the following code block:

var v1BaseUrl = "https://graph.microsoft.com/v1.0/education";
var betaBaseUrl = "https://graph.microsoft.com/beta/education";  // for administrativeUnit and educationOrganization

Representación JSONJSON representation

La siguiente es una representación JSON del recursoThe following is a JSON representation of the resource.

{
  "id": "string",
  "accountEnabled": true,
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "businessPhones": ["555-555-6568"],
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "middleName": "string",
  "surname": "string",
  "mail": "string",
  "mailNickname": "string",
  "mobilePhone": "string",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "externalSource": "string",
  "mailingAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "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"},
  "teacher": {"@odata.type": "microsoft.graph.educationTeacher"},
  "usageLocation": "string",
  "userPrincipalName": "string",
  "userType": "string"
}