Tipo de recurso de usuário

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa uma conta de usuário Microsoft Entra. Esse recurso é um tipo aberto que permite que outras propriedades sejam passadas. Herda de directoryObject.

O recurso do usuário permite que os aplicativos especifiquem as preferências do usuário para idiomas e formatos de data/hora para as caixas de correio e o perfil de Microsoft Entra primário do exchange do usuário. Para obter mais informações, consulte preferências do usuário para idiomas e formatos regionais.

Por motivos de desempenho, as operações create, get e list retornam por padrão apenas um subconjunto das propriedades usadas com mais frequência. Essas propriedades padrão estão listadas na seção Propriedades. Para obter qualquer uma das propriedades não retornadas por padrão, especifique-as em uma $select opção de consulta OData.

Esse recurso permite:

Métodos

Método Tipo de retorno Descrição
Listar usuários Coleção user Recuperar uma lista de objetos user.
Criar usuário user Criar um novo objeto user.
Obter usuário user Ler propriedades e relações do objeto user.
Atualizar usuário user Atualizar o objeto user.
Excluir usuário Nenhum Excluir o objeto user.
Obter delta Coleção usuário Obter as alterações incrementais para usuários.
changePassword Nenhum Atualize sua senha.
Converter usuário externo em usuário membro interno user Converta um usuário autenticado externamente em um usuário membro interno.
invalidateAllRefreshTokens user Invalidar todos os tokens de atualização do usuário emitidos para as aplicações.
validatePassword passwordValidationInformation Valide a senha de um usuário na política de validação de senha da organização e informe se a senha é válida.
Atribuição de funções do aplicativo
List appRoleAssignments appRoleAssignment collection Obtenha as funções de aplicativos e aplicativos atribuídas por um usuário.
Listar appRoleAssignedResources servicePrincipal collection Obtenha os aplicativos que um usuário tem uma atribuição de função de aplicativo diretamente ou por meio da associação de grupo.
Adicionar uma atribuição de função do aplicativo appRoleAssignment Atribua uma função de aplicativo a um usuário.
Remover uma atribuição de função do aplicativo Nenhum Remova uma atribuição de função de aplicativo de um usuário.
Calendar
Criar calendário Calendar Criar um novo Calendar postando na coleção calendars.
Criar calendarGroup CalendarGroup Criar um novo CalendarGroup postando na coleção calendarGroups.
Criar evento event Criar um novo Event postando na coleção de eventos.
findMeetingTimes meetingTimeSuggestionsResult Encontrar o tempo e locais para reunião com base na disponibilidade dos participantes, localização ou restrições de tempo.
findRooms Coleção emailaddress.md Obtenha todas as salas de reunião no locatário do usuário ou em uma lista de salas específica.
findRoomLists Coleção emailaddress.md Obter as listas de salas definidas em um locatário.
getSchedule scheduleInformation Obtenha as informações de disponibilidade gratuita/ocupada para uma coleção de usuários, listas de distribuições ou recursos (salas ou equipamentos) por um período especificado.
Listar calendários Coleção Calendar Obter uma coleção de objetos Calendar.
Listar calendarGroups Coleção CalendarGroup Obter uma coleção de objetos CalendarGroup.
Listar calendarView Coleção event Obter uma coleção de objetos de evento.
Listar eventos Coleção event Obter uma lista de objetos de evento na caixa de correio do usuário. A lista contém reuniões de instância única e reuniões mestres em série.
reminderView Coleção Reminder Retorna uma lista de lembretes de calendário nas horas de início e término especificadas.
Contatos
Criar contato contato Crie um novo contato postando na coleção de contatos.
Criar contactFolder contactFolder Crie um novo contactFolder postando na coleção contactFolders.
Listar contatos Coleção Contact Obter uma coleção de contatos da pasta padrão de contatos do usuário conectado.
Listar contactFolders Coleção ContactFolder Obtenha a coleção de pastas de contatos na pasta de contatos padrão do usuário conectado.
Objetos de diretório
assignLicense user Adicionar ou remover assinaturas para o usuário. Você também pode habilitar e desabilitar planos específicos associados a uma assinatura.
exportPersonalData Nenhum Envia uma solicitação de operação de política de dados feita por um administrador da empresa para exportar dados de um usuário organizacional.
getByIds Coleção de cadeias de caracteres Retorna os objetos de diretório especificados em uma lista de IDs.
checkMemberGroups Coleção de cadeias de caracteres Verifique se há uma associação em uma lista de grupos. A verificação é transitiva.
checkMemberObjects Coleção de cadeias de caracteres Verifique a associação em uma lista de grupo, função de diretório ou objetos de unidade administrativa. A verificação é transitiva.
getMemberGroups String collection Retorne todos os grupos dos quais o usuário é membro. A verificação é transitiva.
getMemberObjects Coleção String Retorne todos os grupos, funções de diretório e unidades administrativas das quais o usuário é membro. A verificação é transitiva.
Get transitiveReports Inteiro Obtenha a contagem de relatórios transitivos para um usuário na propriedade de navegação transitiveReports.
Listar createdObjects Coleção directoryObject Obter os objetos directory criados pelo usuário da propriedade de navegação createdObjects.
Listar licenseDetails Coleção licenseDetails Obtenha uma coleção de objetos licenseDetails.
Listar ownedDevices Coleção directoryObject Obtenha os dispositivos que o usuário possui da propriedade de navegação ownedDevices.
Listar ownedObjects Coleção directoryObject Obtenha os objetos de diretório de propriedade do usuário da propriedade de navegação ownedObjects.
Listar registeredDevices Coleção directoryObject Obter os dispositivos que estão registrados para o usuário da propriedade de navegação registeredDevices.
Listar associações de função com escopo Coleção scopedRoleMembership Obter as associações de unidades administrativas de função com escopo deste usuário.
List usageRights Coleção usageRight Obtenha uma coleção de direitos de uso concedidos ao usuário.
reprocessLicense user Reprocessar as atribuições de assinatura do usuário.
revokeSignInSessions Nenhum Revoga todos os tokens de atualização e sessão do usuário emitidos para aplicativos redefinindo a propriedade de usuário signInSessionsValidFromDateTime para a data-hora atual. Essa operação força o usuário a entrar nesses aplicativos novamente. Este método substitui invalidateAllRefreshTokens.
Listar usuários excluídos Coleção directoryObject Recupere os usuários excluídos no locatário nos últimos 30 dias.
Obter usuário excluído Coleção directoryObject Recupere um usuário excluído por ID.
Restaurar usuário excluído Coleção directoryObject Restaure um usuário excluído do locatário nos últimos 30 dias.
Excluir usuário permanentemente Coleção directoryObject Exclua permanentemente um usuário excluído do locatário.
Unidade
Obter unidade unidade Recuperar as propriedades e as relações de um recurso Drive.
Filhos de lista DriveItems Retornar uma coleção de DriveItems no relacionamento filho de um DriveItem.
Grupos
Listar joinedTeams Coleção team Obter as equipes do Microsoft Teams no qual o usuário é membro direto da propriedade de navegação joinedTeams.
Listar memberOf Coleção directoryObject Obtenha os grupos, funções de diretório e unidades administrativas das quais o usuário é membro direto. Essa operação não é transitiva.
Lista transitiveMemberOf Coleção directoryObject Obtenha os grupos, funções de diretório e as unidades administrativas das quais o usuário é membro através de afiliação direta ou transitória.
Percepções
Listar compartilhado coleção sharedInsight Visão calculada que retorna a lista de arquivos compartilhados com um usuário.
Listar tendências coleção tendências Insights calculados que retornam a lista de itens de tendências do usuário.
Listar usados coleção usedInsight Visão calculada que retorna a lista de arquivos usados com um usuário.
Email
Create inferenceClassificationOverride inferenceClassificationOverride Criar uma substituição da Caixa de Entrada Destaques para um remetente identificado por um endereço SMTP.
Criar MailFolder mailFolder Criar uma nova MailFolder postando na coleção mailFolders
Criar mensagem message Crie uma mensagem postando na coleção de mensagens.
Criar messageRule messageRule Crie um objeto messageRule especificando um conjunto de condições e ações.
getMailTips Coleção mailTips Retornar dicas de email de um ou mais destinatários conforme disponíveis para o usuário conectado.
Listar mailFolders Coleção mailFolder Obter o conjunto de pastas de email sob a pasta raiz do usuário conectado.
Listar mensagens Coleção message Obter todas as mensagens na caixa de correio do usuário conectado.
List overrides Coleção inferenceClassificationOverride Obtenha as substituições de caixa de entrada focadas que um usuário configura para classificar mensagens de determinados remetentes de maneiras específicas.
Listar regras Coleção messageRule Obtenha todos os objetos messageRule definidos para a caixa de entrada do usuário.
Enviar email Nenhum Enviar a mensagem especificada no corpo da solicitação.
Anotações
Criar bloco de anotações bloco de anotações Crie um novo bloco de anotações do OneNote.
Listar blocos de anotações Coleção bloco de anotações Recuperar uma lista de objetos do bloco de anotações.
Extensões abertas
Criar extensão aberta openTypeExtension Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso.
Obter extensão aberta Coleção openTypeExtension Obtenha uma extensão aberta identificada pelo nome da extensão.
Hierarquia da organização
Atribuir gerenciador Nenhum Atribuir um gerenciador de usuário.
Obter gerenciador directoryObject Obter o usuário ou contato que é o gerente do usuário da propriedade de navegação manager.
Remover gerenciador Nenhum Remova o gerente de um usuário.
Listar directReports Coleção directoryObject Obter os usuários ou contatos subordinados ao usuário da propriedade de navegação directReports.
Configurações do Outlook
Criar categoria do Outlook outlookCategory Cria um objeto outlookCategory na lista mestra de categorias do usuário.
Obter supportedLanguages, Coleção localeInfo Obtém a lista de locais e idiomas com suporte para o usuário, conforme configurado no servidor de caixa de correio do usuário.
Obter supportedTimeZones Coleção timeZoneInformation Obtém a lista de fusos horários com suporte para o usuário, conforme configurado no servidor de caixa de correio do usuário.
Obtém configurações de caixa de correio do usuário mailboxSettings Obtém as configurações de caixa de correio do usuário.
Listar as categorias do Outlook Coleção outlookCategory Obtenha todas as categorias definidas para o usuário.
Converter IDs do Exchange coleção convertIdResult Traduzir os identificadores de recursos relacionados ao Outlook entre formatos.
Atualizar configurações da caixa de correio do usuário mailboxSettings Habilitar, configurar ou desabilitar uma ou mais caixas de correioSettings para um usuário.
Credenciais de logon único baseadas em senha
getPasswordSingleSignOnCredentials coleção passwordSingleSignOnCredentialSet Obtenha a lista de credenciais de logon único baseadas em senha para determinado usuário. As senhas nunca são retornadas e, em vez disso, sempre são retornadas como cadeias de caracteres nulas ou vazias.
deletePasswordSingleSignOnCredentials Nenhum Exclua a credencial de logon único baseada em senha para uma determinada entidade de serviço associada a um determinado usuário.
Pessoas
Listar pessoas person Recupere uma lista de objetos person ordenados por relevância para o usuário, o que é determinado pelos padrões de comunicação e colaboração e pelas relações comerciais do usuário.
Foto
Obter foto profilePhoto Obtém o profilePhoto especificado ou seus metadados (propriedades profilePhoto).
Atualizar profilephoto Nenhum Atualize a foto para qualquer usuário no locatário, incluindo o usuário conectado ou o grupo ou contato especificado.
Excluir profilephoto Nenhum Exclua a foto para qualquer usuário no locatário, incluindo o usuário conectado ou o grupo especificado.
Planner
Obter plannerUser plannerUser Recupere as propriedades e relações de um objeto plannerUser.
Listar favoritePlans coleção plannerPlan Recupere uma lista de plannerPlans marcados como favoritos por um usuário.
Listar recentPlans coleção plannerPlan Recupere uma lista de plannerPlans recentemente exibida por um usuário.
Listar tarefas Coleção plannerTask Obter o plannerTasks atribuído ao usuário.
Atualizar plannerUser Nenhum Atualize as propriedades de um objeto plannerUser.
Perfil
Obter perfil perfil Recupere as propriedades e relações de um objeto de perfil para um determinado usuário.
Excluir perfil Nenhum Exclua o objeto de perfil de uma conta de usuário.
Extensões de esquema
Adicionar valores de extensões de esquema Nenhum Crie uma definição de extensão de esquema e use-a para adicionar dados de tipo personalizado a um recurso.
Patrocinadores
Atribuir patrocinadores Nenhum Atribua um patrocinador a um usuário.
Listar patrocinadores Coleção directoryObject Obtenha os usuários e grupos que são os patrocinadores desse usuário.
Remover patrocinadores Nenhum Remova o patrocinador de um usuário.
Teamwork
Lista de aplicativos instalados para o usuário ColeçãouserScopeTeamsAppInstallation Os aplicativos instalados no escopo pessoal desse usuário.
Obter o aplicativo instalado para o usuário userScopeTeamsAppInstallation Lista o aplicativo especificado instalado no escopo pessoal de um usuário.
Adicionar o aplicativo para o usuário Nenhum Adiciona (instala) um aplicativo no escopo pessoal de um usuário.
Remover o aplicativo para o usuário Nenhum Remove (desinstala) um aplicativo no escopo pessoal de um usuário.
Atualizar o aplicativo instalado para o usuário Nenhum Atualizações para a versão mais recente do aplicativo instalada no escopo pessoal de um usuário.
Obter chat entre o usuário e o aplicativo Chat Lista um chat entre o usuário e o aplicativo.
Obter chat entre o usuário e o aplicativo Chat Lista um chat entre o usuário e o aplicativo.
Listar as concessões de permissões Coleção resourceSpecificPermissionGrant Liste todas as concessões de permissão específicas do recurso de um usuário.
Tarefas pendentes
Criar tarefa todoTask Crie um todoTask na lista de tarefas especificada.
Criar uma lista de tarefas todoTaskList Criar uma lista de tarefas To Dona caixa de correio do usuário.
Listar tarefas Coleção todoTask Obtenha todos os recursos todoTask na lista especificada.
Lista de listas de tarefas Coleção todoTaskList Obtenha todas as listas de tarefas na caixa de correio do usuário.
Configurações do usuário
Obter configurações userSettings Leia o usuário e o objeto de configurações da organização.
Atualizar configurações userSettings Atualize as propriedades do objeto de configurações.
Tarefas do Outlook (obsoleto)
Criar outlookTask(obsoleto) outlookTask Criar uma tarefa do Outlook no grupo de tarefas padrão (Minhas Tarefas) e pasta de tarefas padrão (Tarefas) na caixa de correio do usuário.
Listar de tarefas (obsoleto) coleção outlookTask Obtenha todas as tarefas do Outlook na caixa de correio do usuário.
PC na nuvem.
Listar cloudPCs coleção cloudPC Liste os dispositivos cloudPC atribuídos ao usuário conectado.
Obter informações de inicialização cloudPCLaunchInfo Obtenha o cloudPCLaunchInfo para o usuário conectado.

Propriedades

Importante

O uso específico de $filter e o parâmetro de consulta $search é suportado somente quando se usa o cabeçalho ConsistencyLevel definido como eventual e $count. Para obter mais informações, consulte Recursos avançados de consulta em objetos de diretório.

Propriedade Tipo Descrição
aboutMe String Um campo de entrada de texto de forma livre para os usuários se descreverem.

Retornado apenas em $select.
accountEnabled Booliano true se a conta estiver habilitada; caso contrário, false. Essa propriedade é obrigatória quando um usuário é criado.

Suporte $filter (eq, ne, not e in).
ageGroup ageGroup Define a faixa etária do usuário. Valores permitidos: null, Minor, NotAdulte Adult. Para obter mais informações, consulte definições legais de propriedade de faixa etária.

Suporte $filter (eq, ne, not e in).
assignedLicenses Coleção assignedLicense As licenças atribuídas ao usuário, incluindo licenças herdadas (baseadas em grupo). Essa propriedade não diferencia entre licenças atribuídas diretamente e herdadas. Use a propriedade licenseAssignmentStates para identificar as licenças diretamente atribuídas e herdadas.

Não anulável. Suporta $filter (eq, not, /$count eq 0, /$count ne 0).
assignedPlans Coleção assignedPlan Os planos que são atribuídos ao usuário. Somente leitura. Não anulável.

Suporte para $filter (eq e not).
authorizationInfo authorizationInfo Identificadores que podem ser usados para identificar e autenticar um usuário em ambientes não Azure AD. Essa propriedade pode armazenar identificadores para certificados baseados em smartcard que os usuários usam para acessar implantações Active Directory local ou acesso federado. Ele também pode ser usado para armazenar o SAN (Nome Alternativo do Assunto) associado a um CAC (Cartão de Acesso Comum). Anulável.

Suporte para $filter (eq e startsWith).
birthday DateTimeOffset O aniversário do usuário. O tipo carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z

Retornado apenas em $select.
businessPhones String collection Números de telefone para o usuário. Somente um número pode ser definido para essa propriedade.

Somente leitura para usuários sincronizados do diretório local. Suporta $filter (eq, not, ge, le, startsWith).
city Cadeia de caracteres A cidade em que o usuário está localizado. O comprimento máximo é de 128 caracteres.

Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
cloudRealtimeCommunicationInfo cloudRealtimeCommunicationInfo Informações de comunicação em tempo real da Microsoft relacionadas ao usuário.
$filter Dá suporte (eq, ne,not).
CompanyName String O nome da empresa com a qual o usuário está associado. Essa propriedade pode ser útil para descrever a empresa de onde procede um usuário externo. O tamanho máximo é de 64 caracteres.

Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
consentProvidedForMinor consentProvidedForMinor Define se o consentimento foi obtido para menores. Valores permitidos: null, Granted, Denied e NotRequired. Confira as definições de propriedades da faixa etária legal para obter mais informações.

Suporte $filter (eq, ne, not e in).
country Cadeia de caracteres O país ou a região em que o usuário está localizado; por exemplo, US ou UK. O comprimento máximo é de 128 caracteres.

Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
createdDateTime DateTimeOffset A data e hora em que o usuário foi criado no formato ISO 8601 e UTC. Não é possível modificar o valor e ele é preenchido automaticamente quando a entidade é criada. Anulável. Para usuários locais, o valor representa quando eles foram criados pela primeira vez em Microsoft Entra ID. A propriedade é null para alguns usuários criados antes de junho de 2018 e usuários locais sincronizados com Microsoft Entra ID antes de junho de 2018. Somente leitura.

Suporta $filter (eq, ne, not , ge, le, in).
creationType String Indica se a conta do usuário foi criada por meio de um dos seguintes métodos:
  • Como uma conta corporativa ou de estudante (null).
  • Como uma conta externa (Invitation).
  • Como uma conta local para um locatário do Azure Active Directory B2C (LocalAccount).
  • Por meio da inscrição de autoatendimento feita por um usuário interno usando a verificação por email (EmailVerified).
  • Por meio da inscrição de autoatendimento feita por um usuário externo que se inscreveu usando um link que faz parte de um fluxo do usuário (SelfServiceSignUp).

Somente leitura.
Suporte $filter (eq, ne, not e in).
customSecurityAttributes customSecurityAttributeValue Um tipo complexo aberto que contém o valor de um atributo de segurança personalizado atribuído a um objeto do diretório. Anulável.

Retornado apenas em $select. Suporta $filter (eq, ne, not, startsWith). O valor do filtro é sensível a maiúsculas de minúsculas.
deletedDateTime DateTimeOffset A data e hora que o usuário foi excluído.

Suporta $filter (eq, ne, not, ge, le, e in).
departamento String O nome do departamento em que o usuário trabalha. O comprimento máximo é de 64 caracteres.

Suporte $filter (eq, ne, not , ge, le, in, e eq no null valores).
displayName String O nome exibido para o usuário no catálogo de endereços. Geralmente o valor é a combinação do nome, da inicial do nome do meio e do sobrenome do usuário. Essa propriedade é necessária quando um usuário é criado e não pode ser desmarcada durante as atualizações. O comprimento máximo é de 256 caracteres.

Suporte $filter (eq, ne, not , ge, le, in, startsWith, e eq no null valores), $orderby, e $search.
employeeHireDate DateTimeOffset A data e hora em que o usuário foi contratado ou começará a trabalhar se houver uma futura contratação.

Suporta $filter (eq, ne, not , ge, le, in).
employeeLeaveDateTime DateTimeOffset A data e hora em que o usuário saiu ou deixará a organização.

Para ler essa propriedade, o aplicativo de chamada deve receber a permissão User-LifeCycleInfo.Read.All . Para gravar essa propriedade, o aplicativo de chamada deve receber as permissões User.Read.All e User-LifeCycleInfo.ReadWrite.All . Para ler essa propriedade em cenários delegados, o administrador precisa de uma das seguintes funções Microsoft Entra: Administrador de Fluxos de Trabalho do Ciclo de Vida, Leitor Global ou Administrador Global. Para escrever essa propriedade em cenários delegados, o administrador precisa da função de Administrador Global .

Suporta $filter (eq, ne, not , ge, le, in).

Para obter mais informações, consulte Configurar a propriedade employeeLeaveDateTime para um usuário.
employeeId String O identificador de funcionário atribuído ao usuário pela organização. O comprimento máximo é de 16 caracteres.

Suporte $filter (eq, ne, not , ge, le, in, startsWith, e eq no null valores).
employeeOrgData employeeOrgData Representa dados da organização (por exemplo, divisão e costCenter) associados a um usuário.

Suporta $filter (eq, ne, not , ge, le, in).
employeeType String Captura o tipo de trabalhador corporativo. Por exemplo, Employee, Contractor, Consultant ou Vendor. Suporta $filter (eq, ne, not , ge, le, in, startsWith).
externalUserConvertedOn DateTimeOffset A data e hora em que o usuário foi convertido de externo para interno.
externalUserState String Para um usuário externo convidado para o locatário usando a API de convite, essa propriedade representa o status do convite do usuário convidado. Para usuários convidados, o estado pode ser PendingAcceptance ou Accepted ou null para todos os outros usuários.

Suporta $filter (eq, ne, not , in).
externalUserStateChangeDateTime String Mostra o carimbo de hora da alteração mais recente da propriedade externalUserState.

Suporta $filter (eq, ne, not , in).
FaxNumber String O número de fax do usuário.

Suporte $filter (eq, ne, not , ge, le, in, startsWith, e eq no null valores).
givenName String O nome fornecido (nome) do usuário. O comprimento máximo é de 64 caracteres. Suporte $filter (eq, ne, not , ge, le, in, startsWith, e eq no null valores).
hireDate DateTimeOffset A data de contratação do usuário. O tipo carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.

Retornado apenas em $select.
Observação: Esta propriedade é específica do SharePoint Online. Recomendamos usar a propriedade nativa employeeHireDate para definir e atualizar os valores das datas de contratação usando as APIs do Microsoft Graph.
id String O identificador exclusivo do usuário. Ele deve ser tratado como um identificador opaco. Herdado de directoryObject. Não anulável. Somente leitura.

Suporta $filter (eq, ne, not, in).
Identidades Coleção objectIdentity Representa as identidades que podem ser usadas para entrar nesta conta de usuário. Uma identidade pode ser fornecida pela Microsoft (também conhecida como conta local), por organizações ou por provedores de identidade social, como Facebook, Google e Microsoft e vinculada a uma conta de usuário. Ele pode conter vários itens com o mesmo valor signInType .

$filter Dá suporte (eq) com limitações.
imAddresses String collection Os endereços SIP (protocolo de iniciação de sessão) de IP de mensagem instantânea (VOIP) para o usuário. Somente leitura. Suporta $filter (eq, not, ge, le, startsWith).
infoCatalogs Conjunto de cadeias de caracteres Identifica os segmentos de informações atribuídos ao usuário. Suporta $filter (eq, not, ge, le, startsWith).
interests Coleção de cadeias de caracteres Uma lista para os usuários descreverem seus interesses.

Retornado apenas em $select.
isLicenseReconciliationNeeded Booliano Indica se o usuário está pendente de uma atribuição de licença de caixa de correio de troca.

Somente leitura.

$filter Dá suporte (eq somente ondetrue).
isManagementRestricted Booliano true se o usuário for membro de uma unidade administrativa de gerenciamento restrito, o que requer uma função com escopo para a unidade administrativa restrita a ser gerenciada. O valor padrão é false. Somente leitura.

Para gerenciar um usuário que é membro de uma unidade administrativa restrita, o aplicativo de chamada deve receber a permissão Directory.Write.Restricted . Para cenários delegados, os administradores também devem receber funções com suporte explicitamente no escopo da unidade administrativa restrita.
isResourceAccount Boolean Não use – reservado para uso futuro.
jobTitle String O cargo do usuário. O comprimento máximo é de 128 caracteres.

Suporte $filter (eq, ne, not , ge, le, in, startsWith, e eq no null valores).
lastPasswordChangeDateTime DateTimeOffset Quando esse Microsoft Entra usuário alterou sua senha pela última vez ou quando sua senha foi criada, qualquer data em que a ação mais recente foi executada. O tipo carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura.

Retornado apenas em $select.
legalAgeGroupClassification legalAgeGroupClassification Usado por aplicativos empresariais para determinar a faixa etária legal do usuário. Essa propriedade é somente leitura e calculada com base nas propriedades ageGroup e consentProvidedForMinor . Valores permitidos: null, , MinorWithOutParentalConsent, MinorNoParentalConsentRequiredMinorWithParentalConsent, , NotAdulte Adult. Para obter mais informações, consulte definições legais de propriedade de faixa etária.

Retornado apenas em $select.
licenseAssignmentStates Coleção licenseAssignmentState Estado das atribuições de licenças para esse usuário. Ele também indica licenças que são atribuídas diretamente e as herdadas pelo usuário por meio de associações de grupo. Somente leitura.

Retornado apenas em $select.
email String O endereço SMTP do usuário, por exemplo, admin@contoso.com. As alterações nessa propriedade também atualizam a coleção proxyAddresses do usuário para incluir o valor como um endereço SMTP. Essa propriedade não pode conter caracteres de sotaque.
NOTA: Não recomendamos atualizar essa propriedade para Azure AD perfis de usuário B2C. Use em vez da propriedade otherMails.

Suporte $filter (eq, ne, not, ge, le, in, startsWith, endsWith, e eq no null valores).
mailboxSettings mailboxSettings Configurações para a caixa de correio principal do usuário conectado. Você pode obter ou atualizar as configurações de localidade, fuso horário ou de envio de respostas automáticas a mensagens de entrada. Para obter mais informações, confira Preferências do usuário para idiomas e formatos regionais.

Retornado apenas em $select.
mailNickname String O alias de email do usuário. Essa propriedade deve ser especificada quando um usuário é criado. O comprimento máximo é de 64 caracteres.

Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
mobilePhone String O número de celular principal do usuário. Somente leitura para usuários sincronizados do diretório local.

$filter Dá suporte (eq, , notne, ge, le, in, startsWith, e eq em null valores) e $search.
mySite String A URL do site do usuário.

Retornado apenas em $select.
officeLocation String A localização do escritório no local de trabalho do usuário. O comprimento máximo é de 128 caracteres.

Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
onPremisesDistinguishedName String Contém o distinguished name do Active Directory no local ou DN. A propriedade só é preenchida para clientes sincronizando seu diretório local para Microsoft Entra ID por meio do Microsoft Entra Connect. Somente leitura.
onPremisesDomainName String Contém o domainFQDN local, também chamado dnsDomainName sincronizado do diretório local. A propriedade só é preenchida para clientes sincronizando seu diretório local para Microsoft Entra ID por meio do Microsoft Entra Connect. Somente leitura.
onPremisesExtensionAttributes onPremisesExtensionAttributes Contém extensionAttributes1-15 para o usuário. Esses atributos de extensão também são conhecidos como atributos personalizados do Exchange 1-15.
  • Para um usuário onPremisesSyncEnabled, a fonte de autoridade para este conjunto de propriedades é o local e é somente leitura.
  • Para um usuário somente na nuvem (onde onPremisesSyncEnabled é false), essas propriedades podem ser definidas durante a criação ou atualização de um objeto de usuário.
  • Para um usuário somente na nuvem previamente sincronizado a partir do Active Directory local, essas propriedades são somente leitura no Microsoft Graph, mas podem ser totalmente gerenciadas através do Centro de Administração do Exchange ou do módulo Exchange Online V2 no PowerShell.

  • Suporta $filter (eq, ne, not, in).
    onPremisesImmutableId String Essa propriedade associa uma conta de usuário Active Directory local ao objeto Microsoft Entra usuário. Essa propriedade deve ser especificada ao criar uma nova conta de usuário no Graph se você estiver usando um domínio federado para a propriedade UPN (do userPrincipalName usuário). Nota: Os $caracteres e _ não podem ser usados ao especificar essa propriedade.

    Suporta $filter (eq, ne, not, ge, le, in).
    onPremisesLastSyncDateTime DateTimeOffset Indica a última vez em que o objeto foi sincronizado com o diretório local; por exemplo: "2013-02-16T03:04:54Z". O tipo carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura.

    Suporta $filter (eq, ne, not, ge, le, in).
    onPremisesProvisioningErrors coleção OnPremisesProvisioningError Erros ao usar o produto de sincronização da Microsoft durante a configuração.
    Suporta $filter (eq, not, ge, le).
    onPremisesSamAccountName String Contém o sAMAccountName local sincronizado no diretório local. A propriedade só é preenchida para clientes sincronizando seu diretório local para Microsoft Entra ID por meio do Microsoft Entra Connect. Somente leitura.

    Suporta $filter (eq, ne, not, ge, le, in, startsWith).
    onPremisesSecurityIdentifier String Contém o SID (identificador de segurança local) para o usuário sincronizado do local para a nuvem. Somente leitura. Suporta $filter(eq inclusive em null valores).
    onPremisesSipInfo onPremisesSipInfo Contém todas as informações locais do SIP (Protocolo de Iniciação de Sessão) relacionadas ao usuário. Somente leitura.
    onPremisesSyncEnabled Booliano truese esse objeto de usuário estiver sendo sincronizado de um Active Directory local (AD); caso contrário, o usuário não está sendo sincronizado e pode ser gerenciado em Microsoft Entra ID. Somente leitura.

    Suporte $filter (eq, ne, not, in, e eq no null valores).
    onPremisesUserPrincipalName String Contém o userPrincipalName local sincronizado no diretório local. A propriedade só é preenchida para clientes sincronizando seu diretório local para Microsoft Entra ID por meio do Microsoft Entra Connect. Somente leitura.

    Suporta $filter (eq, ne, not, ge, le, in, startsWith).
    otherMails Coleção String Uma lista de endereços de email adicional para o usuário; Por exemplo: ["bob@contoso.com", "Robert@fabrikam.com"].
    OBSERVAÇÃO: essa propriedade não pode conter caracteres de ênfase.

    $filter Dá suporte (eq, , not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).
    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. Para obter mais informações sobre as políticas de senha padrão, consulte Microsoft Entra políticas de senha.

    Suporte $filter (ne, not, e eq no null valores).
    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.

    Suporte $filter (eq, ne, not, in, e eq no null valores).
    pastProjects Coleção de cadeias de caracteres Uma lista para os usuários enumerarem seus projetos anteriores.

    Retornado apenas em $select.
    postalCode String O código postal do endereço postal do usuário. O código postal é específico para o país/região do usuário. Nos Estados Unidos, esse atributo contém o CEP. O comprimento máximo é de 40 caracteres.

    Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
    preferredDataLocation String O local de dados preferido para o usuário. Para saber mais, confira OneDrive Online Multi-Geo.
    preferredLanguage String O idioma preferencial do usuário. O formato de idioma preferencial é baseado no RFC 4646. O nome combina um código de cultura minúscula ISO 639 de duas letras associado ao idioma e um código de subcultura de maiúsculas de duas letras ISO 3166 associado ao país ou região. Exemplo: "en-US", ou "es-ES".

    Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
    preferredName String O nome preferencial do usuário. Sem suporte. Esse atributo retorna uma cadeia de caracteres vazia.

    Retornado apenas em $select.
    provisionedPlans coleção provisionedPlan Os planos que estão provisionados para o usuário. Somente leitura. Não anulável. Suporta $filter (eq, not, ge, le).
    proxyAddresses Coleção de cadeias de caracteres Por exemplo: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. As alterações na propriedade mail também atualizam essa coleção para incluir o valor como um endereço SMTP. Para obter mais informações, consulte propriedades de email e proxyAddresses. O endereço proxy prefixado com SMTP (capitalizado) é o endereço proxy primário, enquanto os prefixados com smtp são os endereços proxy secundários. Para Azure AD contas B2C, essa propriedade tem um limite de 10 endereços exclusivos. Somente leitura no Microsoft Graph; você pode atualizar essa propriedade somente por meio do Microsoft 365 de administração. Não anulável.

    Suporta $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0, /$count ne 0).
    refreshTokensValidFromDateTime DateTimeOffset Todos os tokens de atualização ou tokens de sessões (cookies de sessão) emitidos antes dessa hora são inválidos e os aplicativos recebem um erro ao usar um token de atualização ou sessões inválidos para adquirir um token de acesso delegado (para acessar APIs como o Microsoft Graph). Se isso acontecer, o aplicativo deverá adquirir um novo token de atualização solicitando o ponto de extremidade autorizado. Somente leitura. Use invalidateAllRefreshTokens para redefinir.
    responsibilities Coleção de cadeias de caracteres Uma lista para o usuário enumerar suas responsabilidades.

    Retornado apenas em $select.
    schools Coleção de cadeias de caracteres Uma lista para o usuário enumerar as escolas que frequentou.

    Retornado apenas em $select.
    securityIdentifier Cadeia de Caracteres Identificador de segurança (SID) do usuário, usado em cenários do Windows.

    Somente leitura. Devolvido por padrão.
    Suporta $select e $filter (eq, not, ge, le, startsWith).
    serviceProvisioningErrors coleção serviceProvisioningError Erros publicados por um serviço federado que descreve um erro nãotransiente e específico do serviço em relação às propriedades ou ao link de um objeto de usuário.
    showInAddressList Booliano Não use no Microsoft Graph. Gerencie essa propriedade por meio do Centro de administração do Microsoft 365. Representa se o usuário deve ser incluído na lista de endereços global do Outlook. Consulte Problema conhecido.
    signInSessionsValidFromDateTime DateTimeOffset Todos os tokens de atualização ou tokens de sessões (cookies de sessão) emitidos antes dessa hora são inválidos e os aplicativos recebem um erro ao usar um token de atualização ou sessões inválidos para adquirir um token de acesso delegado (para acessar APIs como o Microsoft Graph). Se isso acontecer, o aplicativo deverá adquirir um novo token de atualização solicitando o ponto de extremidade autorizado. Somente leitura. Use revokeSignInSessions para redefinir.
    skills Coleção de cadeias de caracteres Uma lista para o usuário enumerar suas qualificações.

    Retornado apenas em $select.
    signInActivity signInActivity Obtenha a última data de entrada e solicite a ID de entrada de um usuário específico. Somente leitura.

    Retornado apenas em $select. Dá suporte (eq, , notne, , ge), lemas não com outras $filter propriedades filtradas.

    Observação:
  • Os detalhes dessa propriedade exigem uma licença P1 ou P2 Microsoft Entra ID e a permissão AuditLog.Read.All.
  • Essa propriedade não é retornada para um usuário que nunca entrou ou entrou pela última vez antes de abril de 2020.
  • estado String O estado ou município no endereço do usuário. O comprimento máximo é de 128 caracteres.

    Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
    streetAddress String O endereço do local de trabalho do usuário. O comprimento máximo é de 1024 caracteres.

    Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
    surname String O sobrenome do usuário (nome de família ou sobrenome). O comprimento máximo é de 64 caracteres.

    Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
    usageLocation Cadeia de caracteres Um código de país de duas letras (padrão ISO 3166). Necessário para usuários que recebem licenças devido a requisitos legais para marcar para disponibilidade de serviços em países. Os exemplos incluem:US,JP e GB. Não anulável.

    Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
    userPrincipalName String O nome UPN do usuário. O UPN é um nome de entrada no estilo internet para o usuário 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 deve estar presente na coleção de domínio verificada do locatário. Essa propriedade é obrigatória quando um usuário é criado. Os domínios verificados para o locatário podem ser acessados pela propriedade verifiedDomains de organization.
    OBSERVAÇÃO: essa propriedade não pode conter caracteres de ênfase. Somente os seguintes caracteres são permitidos A - Z, a - z, 0 - 9, ' . - _ ! # ^ ~. Para ver a lista completa de caracteres permitidos, consulte políticas de nome de usuário.

    Suporta $filter (eq, ne, not, ge, le, in, startsWith, endsWith) e $orderby.
    userType String Um valor String que pode ser usado para classificar tipos de usuário em seu diretório. Os valores possíveis são Member e Guest.

    Suporte $filter (eq, ne, not, in, e eq no null valores). NOTA: Para obter mais informações sobre as permissões para usuários membros e convidados, consulte Quais são as permissões de usuário padrão no Microsoft Entra ID?

    Dica

    As extensões de diretório e os dados associados são retornados por padrão; Extensões de esquema e dados associados são retornados apenas em $select; e extensões abertas e dados associados são retornados apenas em $expand.

    propriedades mail e proxyAddresses

    email e proxyAddresses são propriedades relacionadas a email. proxyAddresses é uma coleção de endereços relevantes apenas para o servidor do Microsoft Exchange. Ele é usado para armazenar uma lista de endereços de email para um usuário que está vinculado a uma única caixa de correio. A propriedade mail é usada como o endereço de email do usuário para várias finalidades, incluindo a entrada do usuário, e define o endereço proxy primário.

    email e proxyAddresses podem ser recuperados por meio da API de usuário GET . Você pode atualizar o email por meio da API do usuário de atualização , mas não pode atualizar proxyAddresses por meio do Microsoft Graph. Quando a propriedade de email de um usuário é atualizada, ela dispara um recálculo de proxyAddresses e o email recém-atualizado é definido como o endereço proxy primário, exceto nos seguintes cenários:

    1. Se um usuário tiver uma licença que inclua o Microsoft Exchange, todos os endereços proxy deverão pertencer a um domínio verificado no locatário. Qualquer um que não pertença a domínios verificados é removido silenciosamente.
    2. O email de um usuário NÃO será definido como o endereço proxy primário se o usuário for um convidado e o endereço proxy principal contiver a cadeia de caracteres UPN do usuário convidado com #EXT#.
    3. O email de um usuário NÃO será removido, mesmo que ele não tenha mais endereços proxy se o usuário for um convidado.

    proxyAddresses são exclusivos entre objetos de diretório (usuários, grupos e contatos organizacionais). Se a propriedade de email de um usuário entrar em conflito com um dos proxyAddresses de outro objeto, uma tentativa de atualizar o email falhará e a propriedade proxyAddresses também não será atualizada.

    Preferências do usuário para idiomas e formatos regionais.

    O recurso de usuário contém uma propriedade mailboxSettings que inclui a linguagem preferida do usuário, a formatação de data e hora, o fuso horário padrão e outras configurações especificamente para sua caixa de correio principal do Exchange. Essas preferências são direcionadas a clientes de email e só estão disponíveis se o usuário tiver uma caixa de correio provisionada. Você pode usar caixas de correioSettings se seu cenário se concentrar apenas em tarefas de email, calendário, contatos ou tarefas de tarefas do Outlook.

    Além de mailboxSettings, usuário inclui uma relação por meio de userSettings para regionalAndLanguageSettings, o superconjunto de preferências de formatação regional e de idioma, que pode ser usado por qualquer aplicativo para oferecer ao usuário uma experiência de formatação regional e de idioma melhor. Use userSettings para uma experiência consistente entre aplicativos que tocam no Microsoft Entra perfil de usuário para refletir as mesmas preferências do usuário.

    Esta seção explica como as três propriedades de faixa etária (legalAgeGroupClassification, ageGroup e consentProvidedForMinor) são usadas por administradores Microsoft Entra e desenvolvedores de aplicativos corporativos para atender às regulamentações relacionadas à idade:

    • A propriedade legal AgeGroupClassification é somente leitura. Os desenvolvedores de aplicativos corporativos o usam para garantir o tratamento correto de um usuário com base em sua faixa etária legal. Ele é calculado com base nas propriedades ageGroup e consentProvidedForMinor do usuário.
    • ageGroup e consentProvidedForMinor são propriedades opcionais usadas pelos administradores Microsoft Entra para ajudar a garantir que o uso de uma conta seja tratado corretamente com base nas regras regulatórias relacionadas à idade que regem o país ou a região do usuário.

    Por exemplo, Cameron é administrador de um diretório para uma escola primária em Holyport, no Reino Unido. No início do ano letivo, ele usa a documentação de admissão para obter o consentimento dos pais do menor com base nas regulamentações relacionadas à idade do Reino Unido. O consentimento obtido do pai permite que a conta do menor seja usada por aplicativos da Holyport School e da Microsoft. Cameron cria todas as contas e define o ageGroup para "menor" e consentProvidedForMinor para "concedido". Os aplicativos usados por seus alunos são então capazes de suprimir recursos que não são adequados para menores.

    legalAgeGroupClassification values

    Member Descrição
    null Valor padrão, nenhum ageGroup foi definido para o usuário.
    MenorSemConsentimentoDosPais (Reservado para uso futuro)
    MenorComConsentimentoDosPais O usuário é considerado um menor com base nas regulamentações relacionadas à idade de seu país ou região, e o administrador da conta obteve o consentimento apropriado de um pai ou responsável.
    Adulto O usuário é considerado um adulto com base nas regulamentações relacionadas à idade de seu país ou região.
    NãoAdulto O usuário é de um país ou região que tem regulamentações adicionais relacionadas à idade (como o Estados Unidos, Reino Unido, União Europeia ou Coreia do Sul) e a idade do usuário está entre uma idade menor e adulta (conforme estipulado com base em país ou região). De forma geral, isso significa que os adolescentes são considerados como notAdult em países com regulamentação.
    MenorSemExigênciaDeConsentimentoDosPais O usuário é menor de idade, mas é de um país ou região que não tem com regulamentações relacionadas com a idade.

    ageGroup values

    Member Descrição
    null Valor padrão, nenhum ageGroup foi definido para o usuário.
    Secundária O usuário é considerado um menor.
    NãoAdulto O usuário é de um país que tem regulamentos estatutários Estados Unidos, Reino Unido, União Europeia ou Coreia do Sul) e a idade do usuário é mais do que o limite superior da idade da criança (conforme por país) e menor limite de idade adulta (conforme estipulado com base em país ou região). Basicamente, os adolescentes são considerados como notAdult em países com regulamentação.
    Adulto O usuário deve ser tratado como um adulto.

    consentProvidedForMinor values

    Member Descrição
    null Valor padrão, nenhum consentimentoProvidedForMinor foi definido para o usuário.
    Concedido O consentimento foi obtido para o usuário ter uma conta.
    Negado O consentimento não foi obtido para que o usuário tenha uma conta.
    NãoExigido O usuário é de um local que não requer consentimento.

    Relações

    Relação Tipo Descrição
    activities Coleção userActivity Atividades do usuário em vários dispositivos. Somente leitura. Anulável.
    agreementAcceptances Coleção agreementAcceptance Os termos de usuário do status de aceitação de uso. Somente leitura. Anulável.
    appRoleAssignments appRoleAssignment collection Representa as funções de aplicativo que um usuário recebeu para um programa. Suporta o $expand.
    autenticação autenticação Os métodos de autenticação com suporte para o usuário.
    calendar calendar O calendário principal do usuário. Somente leitura.
    calendarGroups Coleção CalendarGroup Os grupos de calendários do usuário. Somente leitura. Anulável.
    calendarView Coleção event O modo de exibição do calendário. Somente leitura. Anulável.
    calendars Coleção calendar Os calendários do usuário. Somente leitura. Anulável.
    contactFolders Coleção ContactFolder As pastas de contatos do usuário. Somente leitura. Anulável.
    contacts Coleção Contact Os contatos do usuário. Somente leitura. Anulável.
    createdObjects Coleção directoryObject Objetos de diretório que o usuário criou. Somente leitura. Anulável.
    directReports Coleção directoryObject Os usuários e contatos subordinados ao usuário. (Os usuários e contatos com a propriedade do gerente definida como este usuário.) Somente leitura. Anulável. Suporta o $expand.
    Unidade drive O OneDrive do usuário. Somente leitura.
    unidades Coleção drive Uma coleção de unidades disponíveis para esse usuário. Somente leitura.
    events Coleção event Os eventos do usuário. O padrão é mostrar eventos no Calendário Padrão. Somente leitura. Anulável.
    extensions Coleção extension A coleção de extensões abertas definidas para o usuário. Suporta o $expand. Anulável.
    inferenceClassification inferenceClassification Classificação de relevância das mensagens do usuário com base em designações explícitas que substituem relevância ou importância inferidas.
    insights itemInsights Somente leitura. Anulável.
    joinedGroups Coleção group Somente leitura. Anulável.
    mailFolders Coleção mailFolder As pastas de email do usuário. Somente leitura. Anulável.
    manager directoryObject O usuário ou contato que é o gerente deste usuário. Somente leitura. Oferece suporte para $expand.
    memberOf Coleção directoryObject Os grupos, funções de diretório e unidades administrativas das quais o usuário é membro. Somente leitura. Anulável. Suporta o $expand.
    joinedTeams Coleção team O Microsoft Teams equipes do qual o usuário é membro. Somente leitura. Anulável.
    messages Coleção message As mensagens em uma caixa de correio ou pasta. Somente leitura. Anulável.
    onenote onenote Somente leitura.
    onlineMeetings Coleção onlineMeeting Informações sobre uma reunião, incluindo a URL usada para participar de uma reunião, a lista de participantes e a descrição.
    outlook outlookUser Os serviços seletivos do Outlook disponíveis para o usuário. Somente leitura. Anulável.
    ownedDevices Coleção directoryObject Dispositivos pertencentes ao usuário. Somente leitura. Anulável. Suporta o $expand.
    ownedObjects Coleção directoryObject Objetos de diretório pertencentes ao usuário. Somente leitura. Anulável. $expandDá suporte a , $select aninhado em $expand, e $filter (/$count eq 0, , /$count ne 0/$count eq 1, /$count ne 1).
    pendingAccessReviewInstances coleção accessReviewInstance Propriedade de navegação para obter uma lista de revisões de acesso pendentes de aprovação pelo revisor.
    people Coleção person Somente leitura. As pessoas mais relevantes para o usuário. A coleção é ordenada por sua relevância para o usuário, que é determinada pela comunicação, colaboração e relações comerciais do usuário. Uma pessoa agrega informações de email, contatos e redes sociais.
    permissionGrants Coleção resourceSpecificPermissionGrant Liste todas as concessões de permissão específicas do recurso de um usuário.
    photo profilePhoto A foto de perfil do usuário. Somente leitura.
    photos Coleção profilePhoto A coleção de fotos de perfil do usuário em tamanhos diferentes. Somente leitura.
    planner plannerUser Serviços de planejador seletivo disponíveis para o usuário. Somente leitura. Anulável.
    perfil perfil Representa propriedades que são descritivas de um usuário em um locatário.
    registeredDevices Coleção directoryObject Dispositivos que estão registrados para o usuário. Somente leitura. Anulável. $expand Dá suporte e retorna até 100 objetos.
    scopedRoleMemberOf Coleção scopedRoleMembership As associações de unidade administrativa de função com escopo deste usuário. Somente leitura. Anulável.
    Segurança Segurança Anulável.
    settings userSettings Somente leitura. Anulável.
    Patrocinadores Coleção directoryObject Os usuários e grupos responsáveis pelos privilégios desse usuário convidado no locatário e mantêm as informações e o acesso do usuário convidado atualizados. (Métodos HTTP: GET, POST, DELETE.). Oferece suporte para $expand.
    trabalho em equipe userTeamwork Um contêiner dos recursos do Microsoft Teams disponíveis para o usuário. Somente leitura. Anulável.
    todo todo Representa os serviços To Do disponíveis para um usuário.
    transitiveMemberOf Coleção directoryObject Os grupos, incluindo grupos aninhados e funções de diretório das quais um usuário é membro. Anulável.
    transitiveReports Coleção directoryObject Os relatórios transitivos de um usuário. Só leitura.
    Direitosdeuso Coleção usageRight Representa os direitos de uso concedidos a um usuário.

    Representação JSON

    Veja a seguir uma representação JSON do recurso.

    {
      "aboutMe": "String",
      "accountEnabled": true,
      "ageGroup": "String",
      "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
      "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
      "authorizationInfo": {
        "@odata.type": "microsoft.graph.authorizationInfo"
      },
      "birthday": "String (timestamp)",
      "businessPhones": ["String"],
      "city": "String",
      "cloudRealtimeCommunicationInfo": {
        "@odata.type": "microsoft.graph.cloudRealtimeCommunicationInfo"
      },
      "companyName": "String",
      "consentProvidedForMinor": "String",
      "country": "String",
      "createdDateTime": "2019-02-07T21:53:13.067Z",
      "creationType": "String",
      "customSecurityAttributes": {
        "@odata.type": "microsoft.graph.customSecurityAttributeValue"
      },
      "deletedDateTime": "String (timestamp)",
      "department": "String",
      "displayName": "String",
      "employeeHireDate": "2020-01-01T00:00:00Z",
      "employeeId": "String",
      "employeeLeaveDateTime": "String (timestamp)",
      "employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
      "employeeType": "String",
      "externalUserConvertedOn": "String (timestamp)",
      "externalUserState": "PendingAcceptance",
      "externalUserStateChangeDateTime": "2018-11-12T01:13:13Z",
      "faxNumber": "String",
      "givenName": "String",
      "hireDate": "String (timestamp)",
      "id": "String (identifier)",
      "identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
      "interests": ["String"],
      "isLicenseReconciliationNeeded": false,
      "isResourceAccount": false,
      "jobTitle": "String",
      "legalAgeGroupClassification": "String",
      "licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
      "mail": "String",
      "mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
      "mailNickname": "String",
      "mobilePhone": "String",
      "mySite": "String",
      "officeLocation": "String",
      "onPremisesDistinguishedName": "String",
      "onPremisesDomainName": "String",
      "onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
      "onPremisesImmutableId": "String",
      "onPremisesLastSyncDateTime": "String (timestamp)",
      "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
      "onPremisesSamAccountName": "String",
      "onPremisesSecurityIdentifier": "String",
      "onPremisesSipInfo": {
        "@odata.type": "microsoft.graph.onPremisesSipInfo"
      },
      "onPremisesSyncEnabled": true,
      "onPremisesUserPrincipalName": "String",
      "otherMails": ["String"],
      "passwordPolicies": "String",
      "passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
      "pastProjects": ["String"],
      "postalCode": "String",
      "preferredDataLocation": "String",
      "preferredLanguage": "String",
      "preferredName": "String",
      "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
      "proxyAddresses": ["String"],
      "refreshTokensValidFromDateTime": "2019-02-07T21:53:13.084Z",
      "responsibilities": ["String"],
      "schools": ["String"],
      "securityIdentifier": "String",
      "serviceProvisioningErrors": [{"@odata.type": "microsoft.graph.serviceProvisioningXmlError"}],
      "showInAddressList": true,
      "signInSessionsValidFromDateTime": "2019-02-07T21:53:13.084Z",
      "skills": ["String"],
      "state": "String",
      "streetAddress": "String",
      "surname": "String",
      "usageLocation": "String",
      "userPrincipalName": "String",
      "userType": "String",
      "calendar": {"@odata.type": "microsoft.graph.calendar"},
      "calendarGroups": [{"@odata.type": "microsoft.graph.calendarGroup"}],
      "calendarView": [{"@odata.type": "microsoft.graph.event"}],
      "calendars": [{"@odata.type": "microsoft.graph.calendar"}],
      "contacts": [{"@odata.type": "microsoft.graph.contact"}],
      "contactFolders": [{"@odata.type": "microsoft.graph.contactFolder"}],
      "createdObjects": [{"@odata.type": "microsoft.graph.directoryObject"}],
      "directReports": [{"@odata.type": "microsoft.graph.directoryObject"}],
      "drive": {"@odata.type": "microsoft.graph.drive"},
      "drives": [{"@odata.type": "microsoft.graph.drive"}],
      "insights": {"@odata.type": "microsoft.graph.itemInsights"},
      "settings": {"@odata.type": "microsoft.graph.userSettings"},
      "events": [{"@odata.type": "microsoft.graph.event"}],
      "extensions": [{"@odata.type": "microsoft.graph.extension"}],
      "inferenceClassification": {"@odata.type": "microsoft.graph.inferenceClassification"},
      "mailFolders": [{"@odata.type": "microsoft.graph.mailFolder"}],
      "manager": {"@odata.type": "microsoft.graph.directoryObject"},
      "memberOf": [{"@odata.type": "microsoft.graph.directoryObject"}],
      "joinedTeams": [{"@odata.type": "microsoft.graph.group"}],
      "teamwork": {"@odata.type": "microsoft.graph.teamwork"},
      "messages": [{ "@odata.type": "microsoft.graph.message"}],
      "outlook": {"@odata.type": "microsoft.graph.outlookUser"},
      "ownedDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
      "photo": {"@odata.type": "microsoft.graph.profilePhoto"},
      "photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
      "profile": {"@odata.type": "microsoft.graph.profile"},
      "registeredDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
      "signInActivity": {"@odata.type": "microsoft.graph.signInActivity"}
    }