Tipo de recurso educationUser
Namespace: microsoft.graph
Um usuário no sistema. Esta é uma variante específica da educação do utilizador com o mesmo ID que o Microsoft Graph irá devolver do ponto final não específico /users da educação. Este objeto fornece um subconjunto direcionado de propriedades do objeto de utilizador principal e adiciona um conjunto de propriedades específicas da educação, como primaryRole, estudantes e dados do professor .
Herda de entidade.
Methods
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | Coleção educationUser | Obtenha uma lista dos objetos educationUser e respetivas propriedades. |
| Create | educationUser | Crie um novo objeto educationUser . |
| Get | educationUser | Leia as propriedades e relações de um objeto educationUser . |
| Atualizar | educationUser | Atualize as propriedades de um objeto educationUser . |
| Delete | Nenhum | Exclua um objeto educationUser. |
| Obter alterações aos utilizadores | Coleção educationUser | Obter alterações incrementais à coleção de recursos. |
| Listar turmas lecionadas | Coleção educationClass | Obtenha os recursos educationClass da propriedade de navegação classes ensinadas . |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| accountEnabled | Booliano |
True se a conta estiver habilitada; caso contrário, false. Essa propriedade é obrigatória quando um usuário é criado. Oferece suporte para $filter. |
| assignedLicenses | Coleção assignedLicense | As licenças que são atribuídas ao usuário. Não anulável. |
| assignedPlans | Coleção assignedPlan | Os planos que são atribuídos ao usuário. Somente leitura. Não anulável. |
| businessPhones | Coleção de cadeias de caracteres | Números de telefone para o usuário. Observação: embora essa seja uma coleção de cadeias de caracteres, somente um número pode ser definido para essa propriedade. |
| createdBy | identitySet | A entidade que criou o utilizador. |
| department | String | O nome do departamento no qual o usuário trabalha. Oferece suporte para $filter. |
| displayName | String | O nome exibido para o usuário no catálogo de endereços. Geralmente é a combinação do nome, da inicial do nome do meio e do sobrenome do usuário. Essa propriedade é obrigatória quando um usuário é criado e não pode ser apagado durante atualizações. Oferece suporte para $filter e $orderby. |
| externalSource | educationExternalSource | De onde esse usuário foi criado. Os valores possíveis são: sis e manual. |
| externalSourceDetail | Cadeia de caracteres | O nome da origem externa de onde este recurso foi gerado. |
| givenName | String | O nome fornecido (nome) do usuário. Oferece suporte para $filter. |
| id | Cadeia de caracteres | Identificador de objeto. Herdado da entidade. |
| String | O endereço SMTP do usuário, por exemplo, jeff@contoso.com. Somente Leitura. Oferece suporte para $filter. |
|
| mailingAddress | physicalAddress | O endereço de correio do utilizador. |
| mailNickname | String | O alias de email do usuário. Essa propriedade deve ser especificada quando um usuário é criado. Oferece suporte para $filter. |
| middleName | String | O nome do meio do utilizador. |
| mobilePhone | String | O número de celular principal do usuário. |
| officeLocation | String | A localização do escritório para o utilizador. |
| onPremisesInfo | educationOnPremisesInfo | Informações adicionais utilizadas para associar o utilizador do Microsoft Entra à sua contraparte do Active Directory. |
| passwordPolicies | String | Especifica as políticas de senha do usuário. Este valor é uma enumeração com um valor possível sendo DisableStrongPassword, que permite que senhas mais fracas do que a política padrão sejam especificadas.
DisablePasswordExpiration também pode ser especificado. Os dois podem ser especificados em conjunto; por exemplo: DisablePasswordExpiration, DisableStrongPassword. |
| passwordProfile | passwordProfile | Especifica o perfil de senha do usuário. O perfil contém a senha do usuário. Essa propriedade é obrigatória quando um usuário é criado. A senha no perfil deve atender a requisitos mínimos, conforme especificado pela propriedade passwordPolicies. Por padrão, é obrigatória uma senha forte. |
| preferredLanguage | Cadeia de caracteres | O idioma preferencial para o utilizador que deve seguir o código ISO 639-1, por exemplo, en-US. |
| primaryRole | educationUserRole | Função padrão de um usuário. A função do usuário pode ser diferente em uma aula individual. Os valores possíveis são: student, teacher, none, unknownFutureValue. |
| provisionedPlans | coleção provisionedPlan | Os planos que estão provisionados para o usuário. Somente leitura. Não anulável. |
| refreshTokensValidFromDateTime | DateTimeOffset | Todos os tokens de atualização ou tokens de sessões (cookies de sessão) emitidos antes desta hora são inválidos e as aplicações recebem um erro ao utilizar um token de atualização ou sessão inválido para adquirir um token de acesso delegado (para aceder a APIs como o Microsoft Graph). Se isto acontecer, a aplicação tem de adquirir um novo token de atualização ao pedir o ponto final autorizado. Retornado apenas em $select. Somente leitura. |
| relatedContacts | relatedContact collection | Registos relacionados associados ao utilizador. Somente leitura. |
| residenceAddress | physicalAddress | O endereço onde o utilizador reside. |
| showInAddressList | Booliano |
True se a Lista de Endereços Globais do Outlook deve conter este utilizador; caso contrário, false. Se não estiver configurado, isso será tratado como true. Para os usuários convidados por meio do Gerenciador de convites, essa propriedade será definida como false. |
| student | educationStudent | Se a função principal for aluno, esse bloco conterá dados específicos do aluno. |
| surname | String | O sobrenome do usuário (nome de família ou sobrenome). Oferece suporte para $filter. |
| teacher | educationTeacher | Se a função principal for professor, este bloco irá conter dados específicos do professor. |
| usageLocation | Cadeia de caracteres | Um código de país de duas letras (padrão ISO 3166). Obrigatório para os usuários que receberão licenças devido à exigência legal de verificar a disponibilidade de serviços em países ou regiões. Os exemplos incluem:US,JP e GB. Não anulável. Oferece suporte para $filter. |
| userPrincipalName | String | O nome UPN do usuário. O UPN é um nome de início de sessão ao estilo da Internet para o utilizador com base no RFC 822 padrão da Internet. Por convenção, ele deve ser mapeado para o nome de email do usuário. O formato geral é alias@domain, em que o domínio tem de estar presente na coleção de domínios verificados do inquilino. Essa propriedade é obrigatória quando um usuário é criado. Os domínios verificados do inquilino podem ser acedidos a partir da propriedade verifiedDomains da organização. Oferece suporte para $filter e $orderby. |
| userType | String | Um valor de string que pode ser usado para classificar tipos de usuário em seu diretório, como Member e Guest. Oferece suporte para $filter. |
Importante
Ao utilizar âmbitos de permissão Delegados, o Microsoft Graph só devolverá um conjunto limitado de propriedades: id, primaryRole, accountEnabled, displayName, givenName, apelido, userPrincipalName, userType, onPremisesInfo, student/externalId, professor/externalId. Se a sua aplicação precisar de propriedades adicionais, tem de utilizar os Âmbitos de permissão da aplicação.
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| assignments | coleção educationAssignment | Atribuições pertencentes ao utilizador. |
| classes | Coleção educationClass | Aulas às quais o usuário pertence. Anulável. |
| schools | Coleção educationSchool | Escolas às quais o usuário pertence. Anulável. |
| classes ensinadas | Coleção educationClass | Turmas para as quais o utilizador é professor. |
| usuário | user | O utilizador do diretório que corresponde a este utilizador. |
| rubricas | educationRubric collection | Quando definida, a rubrica de classificação anexada à tarefa. |
Representação JSON
A representação JSON seguinte mostra o 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"
}