Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Um usuário no sistema. Essa é uma variante específica para educação do usuário com a mesma ID que o Microsoft Graph retornará do ponto de extremidade não específico /users para educação. Esse objeto fornece um subconjunto de destino de propriedades do objeto de usuário principal e adiciona um conjunto de propriedades específicas da educação, como dados primaryRole, student e teacher .
Herda de entidade.
Methods
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | Coleção educationUser | Obtenha uma lista dos objetos educationUser e suas propriedades. |
| Create | educationUser | Crie um novo objeto educationUser . |
| Get | educationUser | Leia as propriedades e as relações de um objeto educationUser . |
| Atualizar | educationUser | Atualize as propriedades de um objeto educationUser . |
| Delete | Nenhum | Exclua um objeto educationUser. |
| Obter alterações para os usuários | Coleção educationUser | Obtenha alterações incrementais na coleção de recursos. |
| Listar as aulas ministradas | Coleção educationClass | Obtenha os recursos educationClass da propriedade de navegação taughtClasses . |
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 | String collection | 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 usuário. |
| 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, manual. |
| externalSourceDetail | Cadeia de caracteres | O nome da fonte externa da qual esse 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 email do usuário. |
| 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 usuário. |
| mobilePhone | String | O número de celular principal do usuário. |
| officeLocation | String | O local do escritório para o usuário. |
| onPremisesInfo | educationOnPremisesInfo | Informações adicionais usadas para associar o usuário do Microsoft Entra ao seu equivalente 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 juntos; 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 usuário 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ão (cookies de sessão) emitidos antes desse horário são inválidos, e os aplicativos recebem um erro ao usar um token de atualização ou sessões inválido para adquirir um token de acesso delegado (para acessar APIs como o Microsoft Graph). Se isso acontecer, o aplicativo precisará adquirir um novo token de atualização solicitando o ponto de extremidade autorizado. Requer $select recuperação. Somente leitura. |
| relacionadosContatos | relatedColeção de contatos | Registros relacionados associados ao usuário. Somente leitura. |
| residenceAddress | physicalAddress | O endereço onde o usuário mora. |
| showInAddressList | Booliano |
True se a Lista de Endereços Global do Outlook deve conter esse usuário; 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, esse bloco 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 logon no estilo da Internet para o usuário com base no padrão da Internet RFC 822. 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 deve estar presente na coleção de domínios verificados do locatário. Essa propriedade é obrigatória quando um usuário é criado. Os domínios verificados para o locatário podem ser acessados 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 usar escopos de permissão delegados, o Microsoft Graph retornará apenas um conjunto limitado de propriedades: id, primaryRole, accountEnabled, displayName, givenName, surname, userPrincipalName, userType, onPremisesInfo, student/externalId, teacher/externalId. Se o aplicativo exigir propriedades adicionais, você deverá usar os escopos de permissão do aplicativo.
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| assignments | coleção educationAssignment | Atribuições pertencentes ao usuário. |
| 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. |
| taughtClasses | Coleção educationClass | Classes das quais o usuário é professor. |
| usuário | user | O usuário do diretório que corresponde a esse usuário. |
| lista de critérios de avaliação | coleção educationRubric | Quando definida, a rubrica de avaliação anexada à tarefa. |
Representação JSON
A representação JSON a seguir 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"
}