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 utilizador Microsoft Entra. Esse recurso é um tipo aberto que permite que outras propriedades sejam passadas. Herda de directoryObject.
O recurso de utilizador permite que as aplicações especifiquem preferências de utilizador para idiomas e formatos de data/hora para as caixas de correio principal do Exchange do utilizador e Microsoft Entra perfil. Para obter mais informações, veja Preferências de utilizador 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 devolvidas por predefinição, especifique-as numa $select
opção de consulta OData.
Esse recurso permite:
- Adicionar os seus dados a propriedades personalizadas como extensões.
- Assinar as notificações de alteração.
- Usar a consulta delta para controlar adições, exclusões e atualizações incrementais oferecendo uma função delta.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
List | Coleção user | Recuperar uma lista de objetos user. |
Create | user | Criar um novo objeto user. |
Get | user | Ler propriedades e relações do objeto user. |
Atualizar | user | Atualizar o objeto user. |
Delete | Nenhum | Excluir o objeto user. |
Obter delta | Coleção usuário | Obter as alterações incrementais para usuários. |
Alterar senha | Nenhum | Atualize sua senha. |
Validar palavra-passe | 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. |
Repetir o aprovisionamento do serviço | Nenhum | Repita o aprovisionamento do serviço de utilizador. |
Converter utilizador externo em utilizador membro interno | user | Converter um utilizador autenticado externamente num utilizador membro interno. |
Invalidar todos os tokens de atualização | user | Invalidar todos os tokens de atualização do usuário emitidos para as aplicações. NÃO UTILIZE. Utilize o método user: revokeSignInSessions. |
Revogar sessões de início de sessão | Nenhum | Revoga todos os tokens de atualização e sessão do utilizador emitidos para as aplicações ao repor a propriedade de utilizador signInSessionsValidFromDateTime para a data-hora atual. Esta operação força o utilizador a iniciar sessão novamente nessas aplicações. Este método substitui invalidateAllRefreshTokens. |
Exportar dados pessoais | Nenhum | Submete um pedido de operação de política de dados feito por um administrador da empresa para exportar os dados de um utilizador organizacional. |
Interação de IA | ||
Obter todas as interações empresariais | coleção aiInteraction | Obtenha todos os dados de interações Microsoft 365 Copilot, incluindo pedidos de utilizador para respostas copilot e Copilot. |
Atribuição de funções do aplicativo | ||
List | appRoleAssignment collection | Obtenha as aplicações e as funções de aplicação que um utilizador foi atribuído. |
Add | appRoleAssignment | Atribuir uma função de aplicação a um utilizador. |
Remove | Nenhum | Remover uma atribuição de função de aplicação de um utilizador. |
Listar appRoleAssignedResources | servicePrincipal collection | Obtenha as aplicações que um utilizador tem uma atribuição de função de aplicação diretamente ou através da associação a grupos. |
Calendar | ||
Listar calendários | Coleção Calendar | Obter uma coleção de objetos Calendar. |
Criar calendário | Calendar | Criar um novo Calendar postando na coleção calendars. |
List calendar groups | Coleção CalendarGroup | Obter uma coleção de objetos CalendarGroup. |
Create calendar group | CalendarGroup | Criar um novo CalendarGroup postando na coleção calendarGroups. |
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. |
Criar evento | event | Criar um novo Event postando na coleção de eventos. |
Encontrar horários de reunião | meetingTimeSuggestionsResult | Encontrar o tempo e locais para reunião com base na disponibilidade dos participantes, localização ou restrições de tempo. |
Encontrar salas | Coleção emailaddress.md | Obtenha todas as salas de reuniões no inquilino do utilizador ou numa lista de salas específica. |
Encontrar listas de salas | Coleção emailaddress.md | Obter as listas de salas definidas em um locatário. |
Obter agenda de disponibilidade | scheduleInformation | Obtenha as informações de disponibilidade de uma coleção de utilizadores, listas de distribuição ou recursos (salas ou equipamentos) durante um período especificado. |
Listar modo de exibição de calendário | Coleção event | Obter uma coleção de objetos de evento. |
Modo de exibição de lembrete | Coleção Reminder | Retorna uma lista de lembretes de calendário nas horas de início e término especificadas. |
Licenciamento na cloud | ||
Listar direitos de utilização | microsoft.graph.cloudLicensing.usageRight collection | Obtenha uma lista dos objetos usageRight concedidos a um utilizador. |
Obter o direito de utilização | microsoft.graph.cloudLicensing.usageRight | Obtenha as propriedades e relações de um objeto usageRight concedido a um utilizador. |
PC na nuvem. | ||
Listar PCs na nuvem | 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. |
Concessões de permissão delegadas | ||
Listar concessões de permissões delegadas | oAuth2PermissionGrant collection | Obtenha uma lista de permissões delegadas concedidas para permitir que uma aplicação cliente aceda a uma API em nome do utilizador. |
Objetos de diretório | ||
Obter por IDs | Coleção String | Retorna os objetos de diretório especificados em uma lista de IDs. |
Obter delta para objeto de diretório | Coleção directoryObject | Obtenha alterações incrementais para objetos de diretório, como utilizadores, grupos, aplicações e principais de serviço. A filtragem é necessária no ID do tipo derivado ou no próprio tipo derivado. Para obter mais informações sobre consultas delta, veja Utilizar a consulta delta para controlar as alterações nos dados do Microsoft Graph. |
Verificar grupos de membros | Coleção de cadeias de caracteres | Verifique se há uma associação em uma lista de grupos. A verificação é transitiva. |
Obter grupos de membros | Coleção de cadeias de caracteres | Devolver todos os grupos de que o utilizador é membro. A verificação é transitiva. |
Verificar objetos de membro | 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. |
Obter objetos de membros | Coleção String | Devolver todos os grupos, funções de diretório e unidades administrativas de que o utilizador é membro. A verificação é transitiva. |
Obter relatórios transitivos | Inteiro | Obtenha a contagem de relatórios transitivos para um usuário na propriedade de navegação transitiveReports. |
Listar objetos criados | Coleção directoryObject | Obter os objetos directory criados pelo usuário da propriedade de navegação createdObjects. |
Listar dispositivos de propriedade | Coleção directoryObject | Obtenha os dispositivos que o utilizador possui a partir da propriedade de navegação OwnedDevices. |
Listar objetos de propriedade | Coleção directoryObject | Obtenha os objetos de diretório pertencentes ao utilizador a partir da propriedade de navegação OwnedObjects. |
Listar grupos excluídos pertencentes ao usuário | Coleção directoryObject | Obtenha os grupos eliminados no inquilino nos últimos 30 dias e que pertencem a um utilizador. |
Listar dispositivos registrados | 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. |
Listar direitos de utilização | Coleção usageRight | Obtenha uma coleção de direitos de uso concedidos ao usuário. |
Listar itens excluídos | Coleção directoryObject | Recupere os usuários excluídos no locatário nos últimos 30 dias. |
Obter item excluído | Coleção directoryObject | Recupere um usuário excluído por ID. |
Restaurar item excluído | Coleção directoryObject | Restaure um usuário excluído do locatário nos últimos 30 dias. |
Excluir permanentemente item | 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 equipes unidas | Coleção team | Obter as equipes do Microsoft Teams no qual o usuário é membro direto da propriedade de navegação joinedTeams. |
Listar membro de | 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. |
Listar membro transitivo de | 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. |
Gerenciamento de licenças | ||
Atribuir licença | user | Adicionar ou remover assinaturas para o usuário. Você também pode habilitar e desabilitar planos específicos associados a uma assinatura. |
Listar detalhes da licença | Coleção licenseDetails | Obtenha uma coleção de objetos licenseDetails. |
Reprocessar atribuição de licença | user | Reprocessar as atribuições de assinatura do usuário. |
Listar pastas de email | Coleção mailFolder | Obter o conjunto de pastas de email sob a pasta raiz do usuário conectado. |
Criar pasta de email | mailFolder | Criar uma nova MailFolder postando na coleção mailFolders |
Listar mensagens | Coleção message | Obter todas as mensagens na caixa de correio do usuário conectado. |
Criar mensagem | message | Crie uma mensagem postando na coleção de mensagens. |
List overrides | Coleção inferenceClassificationOverride | Obtenha as substituições da caixa de entrada destaques que um utilizador configura para classificar mensagens de determinados remetentes de formas específicas. |
Criar substituição | inferenceClassificationOverride | Criar uma substituição da Caixa de Entrada Destaques para um remetente identificado por um endereço SMTP. |
Listar regras | Coleção messageRule | Obtenha todos os objetos messageRule definidos para a caixa de entrada do usuário. |
Criar regra | messageRule | Crie um objeto messageRule especificando um conjunto de condições e ações. |
Enviar email | Nenhum | Enviar a mensagem especificada no corpo da solicitação. |
Obter sugestões de correio | Coleção mailTips | Retornar dicas de email de um ou mais destinatários conforme disponíveis para o usuário conectado. |
Observações | ||
Listar blocos de anotações | Coleção bloco de anotações | Recuperar uma lista de objetos do bloco de anotações. |
Criar bloco de anotações | bloco de anotações | Crie um novo bloco de anotações do OneNote. |
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 gestor | Nenhum | Remova o gestor de um utilizador. |
Listar subordinados diretos | Coleção directoryObject | Obter os usuários ou contatos subordinados ao usuário da propriedade de navegação directReports. |
Configurações do Outlook | ||
Obtém configurações de caixa de correio do usuário | mailboxSettings | Obtém as configurações de caixa de correio do usuário. |
Atualizar configurações da caixa de correio do usuário | mailboxSettings | Ativar, configurar ou desativar uma ou mais caixas de correioDefinições para um utilizador. |
Listar as categorias do Outlook | Coleção outlookCategory | Obtenha todas as categorias definidas para o utilizador. |
Criar categoria do Outlook | outlookCategory | Cria um objeto outlookCategory na lista mestra de categorias do usuário. |
Obter idiomas suportados | 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 fusos horários suportados | 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. |
Traduzir IDs do Exchange | coleção convertIdResult | Traduzir os identificadores de recursos relacionados ao Outlook entre formatos. |
Credenciais de início de sessão único baseado em palavra-passe | ||
Get | passwordSingleSignOnCredentialSet collection (coleção passwordSingleSignOnCredentialSet) | Obtenha a lista de credenciais de início de sessão único baseadas em palavra-passe para um determinado utilizador. As palavras-passe nunca são devolvidas e, em vez disso, são sempre devolvidas como cadeias nulas ou vazias. |
Delete | Nenhum | Elimine a credencial de início de sessão único baseado em palavra-passe para um determinado principal de serviço associado a um determinado utilizador. |
Pessoas | ||
List | 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. |
Contatos pessoais | ||
Listar contatos | Coleção Contact | Obter uma coleção de contatos da pasta padrão de contatos do usuário conectado. |
Criar contato | contato | Crie um novo contato postando na coleção de contatos. |
Listar pastas de contatos | Coleção ContactFolder | Obtenha a coleção de pastas de contatos na pasta de contatos padrão do usuário conectado. |
Criar pasta de contatos | contactFolder | Crie um novo contactFolder postando na coleção contactFolders. |
Fotografia de perfil | ||
Get | profilePhoto | Obtém o profilePhoto especificado ou seus metadados (propriedades profilePhoto). |
Atualizar | Nenhum(a) | Atualize a fotografia para qualquer utilizador no inquilino, incluindo o utilizador com sessão iniciada ou o grupo ou contacto especificado. |
Delete | Nenhum | Elimine a fotografia de qualquer utilizador no inquilino, incluindo o utilizador com sessão iniciada ou o grupo especificado. |
Planner | ||
Listar planos favoritos | coleção plannerPlan | Recupere uma lista de plannerPlans marcados como favoritos por um usuário. |
Listar planos recentes | 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 configurações | Nenhum | Atualize as propriedades de um objeto plannerUser. |
Perfil | ||
Get | perfil | Recupere as propriedades e relações de um objeto de perfil para um determinado usuário. |
Delete | Nenhum | Exclua o objeto de perfil de uma conta de usuário. |
Patrocinadores | ||
Assign | Nenhum | Atribuir um patrocinador a um utilizador. |
List | Coleção directoryObject | Obtenha os utilizadores e grupos que são patrocinadores deste utilizador. |
Remove | Nenhum | Remova o patrocinador de um utilizador. |
Lista convidada por | directoryObject | Obtenha o utilizador ou principal de serviço que convidou o utilizador especificado para o inquilino. |
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. |
Listar as concessões de permissões | Coleção resourceSpecificPermissionGrant | Listar todas as concessões de permissão específicas de recursos de um utilizador. |
Tarefas pendentes | ||
Listar tarefas | Coleção todoTask | Obtenha todos os recursos todoTask na lista especificada. |
Criar tarefa | todoTask | Crie um todoTask na lista de tarefas especificada. |
Lista de listas de tarefas | Coleção todoTaskList | Obtenha todas as listas de tarefas na caixa de correio do usuário. |
Criar uma lista de tarefas | todoTaskList | Criar uma lista de tarefas To Dona caixa de correio do usuário. |
Configurações do usuário | ||
Get | userSettings | Leia o usuário e o objeto de configurações da organização. |
Atualizar | userSettings | Atualize as propriedades do objeto de configurações. |
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, veja Capacidades avançadas de consulta em objetos de diretório.
Propriedade | Tipo | Descrição |
---|---|---|
aboutMe | String | Um campo de entrada de texto de forma livre para os utilizadores 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 , NotAdult e Adult . Para obter mais informações, veja legal age group property definitions (Definições de propriedades do grupo etário legal). 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). Esta propriedade não diferencia entre licenças atribuídas diretamente e herdadas. Utilize 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 utilizados para identificar e autenticar um utilizador em ambientes não Azure AD. Esta propriedade pode armazenar identificadores para certificados baseados em smartcard que os utilizadores utilizam para aceder a implementações Active Directory local ou acesso federado. Também pode ser utilizado para armazenar o Nome Alternativo do Requerente (SAN) associado a um Cartão de Acesso Comum (CAC). Anulável. Suporte para $filter (eq e startsWith ). |
birthday | DateTimeOffset | O aniversário do usuário. O tipo carimbo de data/hora representa informações de data e hora com 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 | Coleção de cadeias de caracteres | 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 onde o utilizador está localizado. O comprimento máximo é de 128 caracteres. Suporte $filter (eq , ne , not , ge , le , in , startsWith , e eq no null valores). |
cloudLicensing | microsoft.graph.cloudLicensing.userCloudLicensing | As relações de um utilizador com os recursos de licenciamento na cloud. |
cloudRealtimeCommunicationInfo | cloudRealtimeCommunicationInfo | Informações de comunicação em tempo real da Microsoft relacionadas com o utilizador. $filter Suporta (eq , ne ,not ). |
CompanyName | String | O nome da empresa à qual o utilizador 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 região onde o utilizador 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 utilizador 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 os utilizadores no local, o valor representa quando foram criados pela primeira vez no Microsoft Entra ID. A propriedade destina-se null a alguns utilizadores criados antes de junho de 2018 e os utilizadores no local 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:
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 e minúsculas. Suporta $filter (eq , ne , not , ge , le , in ). |
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 onde o utilizador 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. Esta propriedade é necessária quando um utilizador é criado e não pode ser limpa 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 utilizador foi contratado ou irá começar a trabalhar se existir uma contratação futura. Suporta $filter (eq , ne , not , ge , le , in ). |
employeeLeaveDateTime | DateTimeOffset | A data e hora em que o utilizador saiu ou sairá da organização. Suporta $filter (eq , ne , not , ge , le , in ). Para obter mais informações, veja Configurar a propriedade employeeLeaveDateTime para um utilizador. |
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 os dados da organização (por exemplo, divisão e costCenter) associados a um utilizador. 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 utilizador 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/hora representa informações de data e hora com 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. 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 uma conta local), por organizações ou por fornecedores de identidade social, como Facebook, Google e Microsoft, e associada a uma conta de utilizador. Pode conter múltiplos itens com o mesmo valor signInType . $filter Suporta (eq ) com limitações. |
imAddresses | String collection | Os endereços SIP (instant message voice-over IP) session initiation protocol (SIP) para o utilizador. 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 utilizadores descreverem os seus interesses. Retornado apenas em $select . |
isLicenseReconciliationNeeded | Booliano | Indica se o utilizador está pendente de uma atribuição de licença de caixa de correio do Exchange. Somente leitura. $filter Suporta (eq onde true apenas). |
isManagementRestricted | Booliano |
true se o utilizador for membro de uma unidade administrativa de gestão restrita. O valor padrão é false . Somente leitura. Para gerir um utilizador que seja membro de uma unidade administrativa de gestão restrita, tem de ser atribuída ao administrador ou à aplicação de chamada uma função Microsoft Entra no âmbito da unidade administrativa de gestão 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 este Microsoft Entra utilizador alterou a palavra-passe pela última vez ou quando a palavra-passe foi criada, independentemente da data em que a ação mais recente foi efetuada. O tipo carimbo de data/hora representa informações de data e hora com 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 MinorWithParentalConsent , MinorNoParentalConsentRequired , e Adult NotAdult . Para obter mais informações, veja legal age group property definitions (Definições de propriedades do grupo etário legal). Retornado apenas em $select . |
licenseAssignmentStates | Coleção licenseAssignmentState | Estado das atribuições de licenças para esse usuário. Também indica licenças atribuídas diretamente e as que o utilizador herdou através de associações a grupos. Somente leitura. Retornado apenas em $select . |
String | O endereço SMTP do usuário, por exemplo, admin@contoso.com . As alterações a esta propriedade também atualizam a coleção proxyAddresses do utilizador para incluir o valor como um endereço SMTP. Esta propriedade não pode conter carateres de destaque. NOTA: Não recomendamos que atualize esta propriedade para Azure AD perfis de utilizador 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. Só de leitura para utilizadores sincronizados a partir do diretório no local. $filter Suporta (eq , ne , not , ge , le , in , startsWith e eq nos null valores) e $search . |
mySite | String | O URL do site do utilizador. 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 . |
onPremisesDomainName | String | Contém o domainFQDN local, também chamado dnsDomainName sincronizado do diretório local. |
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. Cada atributo pode armazenar até 1024 carateres. false ), estas propriedades podem ser definidas durante a criação ou atualização de um objeto de utilizador. Suporta $filter (eq , ne , not , in ). |
onPremisesImmutableId | String | Esta propriedade associa uma conta de utilizador Active Directory local ao respetivo objeto de utilizador Microsoft Entra. Esta propriedade tem de ser especificada ao criar uma nova conta de utilizador no Graph se estiver a utilizar um domínio federado para a propriedade do userPrincipalName utilizador (UPN).
Nota: Os $ carateres e _ não podem ser utilizados ao especificar esta 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/hora representa informações de data e hora com 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. Suporta $filter (eq , ne , not , ge , le , in , startsWith ). |
onPremisesSecurityIdentifier | String | Contém o identificador de segurança (SID) no local para o utilizador sincronizado do local para a cloud. Tem de estar no formato de SID, como "S-1-5-21-1180699209-877415012-3182824384-1006". Suporta $filter (eq inclusive em null valores). |
onPremisesSipInfo | onPremisesSipInfo | Contém todas as informações do Protocolo SIP (Session Initiation Protocol) no local relacionadas com o utilizador. Somente leitura. |
onPremisesSyncEnabled | Booliano |
true se este objeto de utilizador estiver atualmente a ser sincronizado a partir de um Active Directory local (AD); caso contrário, o utilizador não está a ser sincronizado e pode ser gerido no 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. 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"] .NOTA: esta propriedade não pode conter carateres de destaque. Suporta ( eq , , not ge , le , in , , startsWith , endsWith , /$count eq 0 ). /$count ne 0 $filter |
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 palavra-passe predefinidas, consulte Microsoft Entra políticas de palavra-passe. 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). Para atualizar esta propriedade: |
pastProjects | Coleção de cadeias de caracteres | Uma lista para os utilizadores enumerarem os 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 baseia-se no RFC 4646. O nome combina um código de cultura minúscula ISO 639 de duas letras associado à linguagem e um código de subcultura maiúscula ISO 3166 de duas letras 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. Este atributo devolve uma cadeia 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 à propriedade mail também atualizam esta 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 com SMTP prefixo (em maiúsculas) é o endereço proxy principal, enquanto os prefixos smtp com são os endereços proxy secundários. Para Azure AD contas B2C, esta 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 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 tal acontecer, a aplicação tem de adquirir um novo token de atualização ao pedir o ponto final 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 | serviceProvisioningError collection | Erros publicados por um serviço federado que descreve um erro nãotransiente específico do serviço relativamente às propriedades ou ligação de um objeto de utilizador. |
showInAddressList | Booliano | Não utilize no Microsoft Graph. Em vez disso, faça a gestão desta propriedade através 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 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. 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 .
$filter Suporta (eq , ne , not , ge , le ) mas não com outras propriedades filtráveis. Observação: |
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 os utilizadores a que são atribuídas licenças devido a requisitos legais para marcar para disponibilidade de serviços em países/regiões. 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 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, onde 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 para o locatário podem ser acessados pela propriedade verifiedDomains de organization. NOTA: esta propriedade não pode conter carateres de destaque. 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 de Cadeia que pode ser utilizado para classificar tipos de utilizador no 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 utilizadores membros e convidados, consulte Quais são as permissões de utilizador predefinidas no Microsoft Entra ID? |
Dica
As extensões de diretório e os dados associados são devolvidos por predefinição; as extensões de esquema e os dados associados são devolvidos apenas em $select
; e as extensões abertas e os dados associados são devolvidos apenas em $expand
.
propriedades mail e proxyAddresses
email e proxyAddresses são propriedades relacionadas a email. proxyAddresses é uma coleção de endereços apenas relevantes 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 é utilizada como endereço de e-mail do utilizador para várias finalidades, incluindo o início de sessão do utilizador, e define o endereço proxy principal.
O correio e o proxyAddresses podem ser obtidos através da API de utilizador GET . Pode atualizar o correio através da API atualizar o utilizador , mas não pode atualizar proxyAddresses através do Microsoft Graph. Quando a propriedade de correio de um utilizador é atualizada, aciona um recálculo de proxyAddresses e o correio recentemente atualizado é definido como o endereço proxy principal, exceto nos seguintes cenários:
- 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.
- O correio de um utilizador NÃO será definido para o endereço proxy principal se o utilizador for um convidado e o endereço proxy principal contiver a cadeia UPN do utilizador convidado com
#EXT#
. - O correio de um utilizador NÃO será removido, mesmo que já não tenha endereços proxy se o utilizador for um convidado.
proxyAddresses são exclusivos entre objetos de diretório (usuários, grupos e contatos organizacionais). Se a propriedade mail de um utilizador entrar em conflito com um dos proxyAddresses de outro objeto, uma tentativa de atualizar o correio falhará e a propriedade proxyAddresses também não será atualizada.
Preferências do usuário para idiomas e formatos regionais.
O recurso de utilizador contém uma propriedade mailboxDefinições que inclui o idioma preferido do utilizador, a formatação de data e hora, o fuso horário predefinido e outras definições especificamente para a caixa de correio principal do Exchange. Estas preferências são direcionadas para clientes de correio e só estão disponíveis se o utilizador tiver uma caixa de correio aprovisionada. Pode utilizar caixas de correioDefinições se o seu cenário se concentrar apenas no correio, calendário, contactos ou tarefas a fazer 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. Utilize userSettings para uma experiência consistente entre aplicações que acedem ao Microsoft Entra perfil de utilizador para refletir as mesmas preferências de utilizador.
Definições de propriedade da faixa etária legal
Esta secção explica como as propriedades das três faixas etárias (legalAgeGroupClassification, ageGroup e consentProvidedForMinor) são utilizadas por administradores Microsoft Entra e programadores de aplicações empresariais para cumprir os regulamentos relacionados com a idade:
- A propriedade legal AgeGroupClassification é somente leitura. Os programadores de aplicações empresariais utilizam-na para garantir o processamento correto de um utilizador com base no respetivo grupo etário legal. É calculado com base nas propriedades ageGroup e consentProvidedForMinor do utilizador.
- ageGroup e consentProvidedForMinor são propriedades opcionais utilizadas pelos administradores Microsoft Entra para ajudar a garantir que a utilização de uma conta é processada corretamente com base nas regras regulamentares relacionadas com a idade que regem o país ou região do utilizador.
Por exemplo, Cameron é administrador de um diretório de uma escola primária em Holyport, no Reino Unido. No início do ano letivo, utiliza a papelada de admissão para obter o consentimento dos pais do menor com base nos regulamentos relacionados com a idade do Reino Unido. O consentimento obtido junto do encarregado de educação permite que a conta do menor seja utilizada pelas aplicações Holyport School e Microsoft. Cameron cria todas as contas e define o ageGroup para "menor" e consentProvidedForMinor para "concedido". As aplicações utilizadas pelos seus alunos são então capazes de suprimir funcionalidades que não são adequadas 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 utilizador é considerado menor com base nos regulamentos relacionados com a idade do respetivo país ou região e o administrador da conta obteve o consentimento adequado de um encarregado de educação ou tutor. |
Adulto | O utilizador é considerado um adulto com base nos regulamentos relacionados com a idade do respetivo país ou região. |
NãoAdulto | O utilizador é de um país ou região que tem regulamentos adicionais relacionados com a idade (como o Estados Unidos, Reino Unido, União Europeia ou Coreia do Sul) e a idade do utilizador é entre uma idade menor e uma idade adulta (conforme estipulado com base no 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 utilizador é de um país que tem regulamentos legais Estados Unidos, Reino Unido, União Europeia ou Coreia do Sul) e a idade do utilizador é superior ao limite máximo da idade das crianças (por país) e menor do que o limite inferior da idade de adulto (conforme estipulado com base no 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 | Não foi obtido consentimento para o utilizador ter uma conta. |
NãoExigido | O utilizador é proveniente de uma localização 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 utilizador criou. Somente leitura. Anulável. |
directReports | Coleção directoryObject | Os usuários e contatos subordinados ao usuário. (Os utilizadores e contactos com a respetiva propriedade de gestor definida para este utilizador.) Só de 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 este utilizador. Somente leitura. |
events | Coleção event | Os eventos do usuário. A predefinição é mostrar eventos no Calendário Predefinido. 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 por relevância das mensagens do utilizador com base em designações explícitas que substituem a relevância ou importância inferida. |
insights | itemInsights | Representa relações entre um utilizador e itens, como o OneDrive para documentos escolares ou profissionais, calculados através de análises avançadas e técnicas de machine learning. Somente leitura. Anulável. |
invitedBy | directoryObject | O utilizador ou principal de serviço que convidou o utilizador. |
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 dos quais o utilizador é membro. Somente leitura. Anulável. Suporta o $expand . |
joinedTeams | Coleção team | As equipas do Microsoft Teams das quais o utilizador é 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 o URL utilizado para participar numa 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 utilizador. Somente leitura. Anulável. Suporta o $expand . |
ownedObjects | Coleção directoryObject | Objetos de diretório pertencentes ao utilizador. Somente leitura. Anulável.
$expand Suporta , $select aninhado em $expand , e $filter (/$count eq 0 , /$count ne 0 , /$count eq 1 , /$count ne 1 ). |
pendingAccessReviewInstances | accessReviewInstance collection (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 pela respetiva relevância para o utilizador, que é determinada pela comunicação, colaboração e relações comerciais do utilizador. Uma pessoa agrega informações de correio, contactos e redes sociais. |
permissionGrants | Coleção resourceSpecificPermissionGrant | Listar todas as concessões de permissão específicas de recursos de um utilizador. |
photo | profilePhoto | A foto de perfil do usuário. Somente leitura. |
photos | Coleção profilePhoto | A coleção das fotografias de perfil do utilizador 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 Suporta e devolve 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. |
soluções | userSolutionRoot | Representa a entidade de solução personalizada de um utilizador. Somente Leitura. Anulável. |
patrocinadores | Coleção directoryObject | Os utilizadores e grupos responsáveis pelos privilégios deste utilizador convidado no inquilino e mantêm as informações e o acesso do utilizador 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 dos quais um utilizador é 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
A representação JSON seguinte mostra o tipo de 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",
"cloudLicensing": { "@odata.type": "microsoft.graph.cloudLicensing.userCloudLicensing" },
"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"}
}