Tipo de recurso educationUser
Espacio de nombres: microsoft.graph
Usuario del sistema. Se trata de una variante específica de educación del usuario con el mismo identificador que Microsoft Graph devolverá del 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, student y los datos del profesor .
Hereda de la entidad.
Methods
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | Colección educationUser | Obtenga una lista de los objetos educationUser y sus propiedades. |
| Crear | educationUser | Cree un nuevo objeto educationUser . |
| Get | educationUser | Lea las propiedades y relaciones de un objeto educationUser . |
| Actualizar | educationUser | Actualice las propiedades de un objeto educationUser . |
| Delete | Ninguno | Elimine un objeto educationUser. |
| Obtención de cambios en los usuarios | Colección educationUser | Obtenga cambios incrementales en la colección de recursos. |
| Enumeración de clases impartidas | Colección educationClass | Obtenga los recursos educationClass de la propiedad de navegación taughtClasses . |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| 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 creó el usuario. |
| department | Cadena | El nombre del departamento en el que trabaja el usuario. Admite $filter. |
| displayName | Cadena | Nombre del usuario que aparece en la libreta de direcciones. Suele ser la combinación del nombre del usuario, la inicial del segundo nombre y el apellido. Esta propiedad es necesaria cuando se crea un usuario y no se puede borrar durante las actualizaciones. Admite $filter y $orderby. |
| externalSource | educationExternalSource | Indica desde dónde se ha creado este usuario. Los valores posibles son sis y manual. |
| externalSourceDetail | Cadena | Nombre del origen externo desde el que se generó este recurso. |
| givenName | Cadena | El nombre (nombre de pila) del usuario. Admite $filter. |
| id | Cadena | Identificador de objeto. Heredado de la entidad. |
| Cadena | La dirección SMTP del usuario (por ejemplo, la dirección jeff@contoso.com). Solo lectura. Admite $filter. |
|
| mailingAddress | physicalAddress | Dirección de correo del usuario. |
| mailNickname | Cadena | El alias de correo del usuario. Esta propiedad debe especificarse al crear un usuario. Admite $filter. |
| middleName | String | El segundo nombre del usuario. |
| mobilePhone | String | El número de teléfono móvil principal del usuario. |
| officeLocation | String | Ubicación de la oficina del usuario. |
| onPremisesInfo | educationOnPremisesInfo | Información adicional que se usa para asociar el usuario de Microsoft Entra a su homólogo de Active Directory. |
| passwordPolicies | String | Especifica las directivas de contraseña del usuario. Este valor es una enumeración con un valor posible que es DisableStrongPassword, el cual permite especificar contraseñas menos seguras que la directiva predeterminada.
DisablePasswordExpiration también se puede especificar. Los dos se pueden especificar juntos; por ejemplo: DisablePasswordExpiration, DisableStrongPassword. |
| 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. La contraseña del perfil debe cumplir los requisitos mínimos especificados por la propiedad passwordPolicies. De manera predeterminada, se requiere una contraseña segura. |
| preferredLanguage | Cadena | El idioma preferido para el usuario que debe seguir el código ISO 639-1, por ejemplo, en-US. |
| primaryRole | educationUserRole | Rol predeterminado de un usuario. Puede que el rol del usuario sea distinto en una clase individual. Los valores posibles son: student, teacher, none y unknownFutureValue. |
| provisionedPlans | colección provisionedPlan | Planes que han sido provisionados para el usuario. Solo lectura. No admite valores NULL. |
| refreshTokensValidFromDateTime | DateTimeOffset | Los tokens de actualización o los tokens de sesiones (cookies de sesión) emitidos antes de este momento no son válidos y las aplicaciones reciben un error al usar un token de actualización o sesiones no válido para adquirir un token de acceso delegado (para acceder a las API como Microsoft Graph). Si esto sucede, la aplicación debe adquirir un nuevo token de actualización solicitando el punto de conexión autorizado. Solo se devuelve en $select. Solo lectura. |
| relatedContacts | relatedContact (colección) | Registros relacionados asociados al usuario. Solo lectura. |
| residenceAddress | physicalAddress | Dirección donde reside el usuario. |
| showInAddressList | Boolean |
True si la lista global de direcciones de Outlook debe contener este usuario; De lo contrario, false. Si no se establece, se tratará como true. Para los usuarios invitados a través del administrador de invitaciones, esta propiedad se establecerá en false. |
| student | educationStudent | Si el rol principal es alumno, este bloque contendrá datos específicos de alumnos. |
| surname | Cadena | El apellido (o apellidos) del usuario. Admite $filter. |
| teacher | educationTeacher | Si el rol principal es profesor, este bloque contendrá datos específicos del profesor. |
| usageLocation | String | Código de país de dos letras (norma ISO 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. Algunos ejemplos son: USJP y GB. No admite valores NULL. Admite $filter. |
| userPrincipalName | Cadena | El nombre principal del usuario (UPN) del usuario. El UPN es un nombre de inicio de sesión de estilo internet para el usuario basado en la rfc 822 estándar de Internet. Por convención, se debe asignar al nombre de correo electrónico del usuario. El formato general es alias@domain, donde el dominio debe estar presente en la colección de dominios comprobados del inquilino. Esta propiedad es necesaria cuando se crea un usuario. Se puede acceder a los dominios comprobados para el inquilino desde la propiedad verifiedDomains de la organización. Admite $filter y $orderby. |
| userType | Cadena | Un valor de cadena puede utilizarse para clasificar los tipos de usuario en el directorio. Por ejemplo: Member e Guest. Admite $filter. |
Importante
Al usar ámbitos de permisos delegados, Microsoft Graph solo devolverá un conjunto limitado de propiedades: id, primaryRole, accountEnabled, displayName, givenName, surname, userPrincipalName, userType, onPremisesInfo, student/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 | colección educationAssignment | Asignaciones que pertenecen al usuario. |
| 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. |
| usuario | user | El usuario de directorio que corresponde a este usuario. |
| 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.
{
"@odata.type": "#microsoft.graph.educationUser",
"accountEnabled": "Boolean",
"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",
"externalSourceDetail": "String",
"givenName": "String",
"id": "String (identifier)",
"mail": "String",
"mailingAddress": {
"@odata.type": "microsoft.graph.physicalAddress"
},
"mailNickname": "String",
"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"
}
],
"refreshTokensValidFromDateTime": "String (timestamp)",
"residenceAddress": {
"@odata.type": "microsoft.graph.physicalAddress"
},
"showInAddressList": "Boolean",
"student": {
"@odata.type": "microsoft.graph.educationStudent"
},
"surname": "String",
"teacher": {
"@odata.type": "microsoft.graph.educationTeacher"
},
"usageLocation": "String",
"userPrincipalName": "String",
"userType": "String"
}