Obter um usuárioGet a user

Recupere as propriedades e os relacionamentos do objeto user.Retrieve the properties and relationships of user object.

Observação: obter um usuário retorna uma coleção padrão de propriedades somente (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName). Use $select para obter outras propriedades e relacionamentos para o objeto user.Note: Getting a user returns a default set of properties only (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName). Use $select to get the other properties and relationships for the user object.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllUser.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) User.Read, User.ReadWriteUser.Read, User.ReadWrite
AplicativoApplication User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.AllUser.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

Solicitação HTTPHTTP request

Para um usuário específico:For a specific user:

GET /users/{id | userPrincipalName}

Para o usuário conectado:For the signed-in user:

GET /me

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the OData Query Parameters to help customize the response.

Por padrão, somente um conjunto limitado de propriedades é retornado (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName).By default, only a limited set of properties are returned ( businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName ).

Para retornar um conjunto de propriedades alternativo, você deve especificar o conjunto desejado das propriedades user usando o parâmetro de consulta OData $select.To return an alternative property set, you must specify the desired set of user properties using the OData $select query parameter. Por exemplo, para retornar displayName, givenName e postalCode, você pode adicionar o seguinte à consulta $select=displayName,givenName,postalCodeFor example, to return displayName, givenName, and postalCode, you would use the add the following to your query $select=displayName,givenName,postalCode

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se bem-sucedido, este método retorna o código de resposta 200 OK e o objeto user no corpo da resposta.If successful, this method returns a 200 OK response code and user object in the response body.

Esse método retorna 202 Accepted quando a solicitação tiver sido processada com sucesso, mas o servidor requer mais tempo para concluir as operações de segundo plano relacionadas.This method returns 202 Accepted when the request has been processed successfully but the server requires more time to complete related background operations.

ExemplosExamples

Exemplo 1: Solicitação de usuários padrãoExample 1: Standard users request

Por padrão, somente um conjunto limitado de propriedades é retornado (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName).By default, only a limited set of properties are returned ( businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName ). Este exemplo ilustra a solicitação padrão e a resposta.This example illustrates the default request and response.

GET https://graph.microsoft.com/v1.0/users/{id | userPrincipalName}
RespostaResponse
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

{
  "businessPhones": [
       "businessPhones-value"
   ],
   "displayName": "displayName-value",
   "givenName": "givenName-value",
   "jobTitle": "jobTitle-value",
   "mail": "mail-value",
   "mobilePhone": "mobilePhone-value",
   "officeLocation": "officeLocation-value",
   "preferredLanguage": "preferredLanguage-value",
   "surname": "surname-value",
   "userPrincipalName": "userPrincipalName-value",
   "id": "id-value"
}

Exemplo 2: solicitação de usuário conectadoExample 2: Signed-in user request

Você pode obter as informações do usuário para o usuário conectado, substituindo /users/{id | userPrincipalName} por /me.You can get the user information for the signed-in user by replacing /users/{id | userPrincipalName} with /me.

SolicitaçãoRequest
GET https://graph.microsoft.com/v1.0/me
RespostaResponse
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

{
  "businessPhones": [
       "businessPhones-value"
   ],
   "displayName": "displayName-value",
   "givenName": "givenName-value",
   "jobTitle": "jobTitle-value",
   "mail": "mail-value",
   "mobilePhone": "mobilePhone-value",
   "officeLocation": "officeLocation-value",
   "preferredLanguage": "preferredLanguage-value",
   "surname": "surname-value",
   "userPrincipalName": "userPrincipalName-value",
   "id": "id-value"
}

Exemplo 3: solicitação de usuários usando $selectExample 3: Users request using $select

Se precisar de um conjunto de propriedades diferente, você poderá usar o parâmetro de consulta OData $select.If you need a different property set, you can use the OData $select query parameter. Por exemplo, para retornar displayName, givenName e postalCode, você pode adicionar o seguinte à consulta $select=displayName,givenName,postalCodeFor example, to return displayName, givenName, and postalCode, you would use the add the following to your query $select=displayName,givenName,postalCode

SolicitaçãoRequest
GET https://graph.microsoft.com/v1.0/users/{id | userPrincipalName}?$select=displayName,givenName,postalCode
RespostaResponse
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

{
   "displayName": "displayName-value",
   "givenName": "givenName-value",
   "postalCode": "postalCode-value"
}