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 un usuario en el 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 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 | 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. |
| 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. |
| 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. 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 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 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 les asignan 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. 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, 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 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ú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"
}