Obtenir un utilisateurGet a user

Récupérez les propriétés et les relations de l’objet de l’utilisateur.Retrieve the properties and relationships of user object.

Remarque : L’obtention d’un utilisateur renvoie uniquement un ensemble de propriétés par défaut (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName). Utilisez $select pour obtenir d’autres propriétés et relations pour l’objet utilisateur.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.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)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
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) User.Read, User.ReadWriteUser.Read, User.ReadWrite
ApplicationApplication User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.AllUser.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

Requête HTTPHTTP request

Pour un utilisateur spécifique :For a specific user:

GET /users/{id | userPrincipalName}

Pour l’utilisateur connecté :For the signed-in user:

GET /me

Paramètres facultatifs de requêteOptional query parameters

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.This method supports the OData Query Parameters to help customize the response.

Par défaut, seul un ensemble limité de propriétés est renvoyé (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 ).

Pour renvoyer un autre jeu de propriétés, vous devez spécifier le jeu souhaité de propriétés user à l’aide du paramètre de requête $select OData.To return an alternative property set, you must specify the desired set of user properties using the OData $select query parameter. Par exemple, pour renvoyer displayName, givenName et postalCode, vous devez ajouter les éléments suivants à votre requête $select=displayName,givenName,postalCode.For example, to return displayName, givenName, and postalCode, you would use the add the following to your query $select=displayName,givenName,postalCode

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet user dans le corps de la réponse.If successful, this method returns a 200 OK response code and user object in the response body.

ExemplesExamples

Exemple 1 : Demande d’utilisateurs standardExample 1: Standard users request

Par défaut, seul un ensemble limité de propriétés est renvoyé (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 ). Cet exemple illustre la demande et la réponse par défaut.This example illustrates the default request and response.

GET https://graph.microsoft.com/v1.0/users/{id | userPrincipalName}
RéponseResponse
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"
}

Exemple 2 : Demande de l’utilisateur connectéExample 2: Signed-in user request

Vous pouvez obtenir les informations de l’utilisateur connecté en remplaçant /users/{id | userPrincipalName} par /me.You can get the user information for the signed-in user by replacing /users/{id | userPrincipalName} with /me.

DemandeRequest
GET https://graph.microsoft.com/v1.0/me
RéponseResponse
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"
}

Exemple 3 : Demande d’utilisateurs à l’aide de $selectExample 3: Users request using $select

Si vous avez besoin d’un autre jeu de propriétés, vous pouvez utiliser le paramètre de requête $select OData.If you need a different property set, you can use the OData $select query parameter. Par exemple, pour renvoyer displayName, givenName et postalCode, vous devez ajouter les éléments suivants à votre requête $select=displayName,givenName,postalCode.For example, to return displayName, givenName, and postalCode, you would use the add the following to your query $select=displayName,givenName,postalCode

DemandeRequest
GET https://graph.microsoft.com/v1.0/users/{id | userPrincipalName}?$select=displayName,givenName,postalCode
RéponseResponse
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

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