Gestion des utilisateurs dans Microsoft GraphWorking with users in Microsoft Graph

Vous pouvez utiliser Microsoft Graph pour créer des expériences d’application convaincantes basées sur les utilisateurs, leurs relations avec d’autres utilisateurs et groupes et leurs courrier, calendrier, fichiers.You can use Microsoft Graph to build compelling app experiences based on users, their relationships with other users and groups, and their mail, calendar, and files.

Vous pouvez accéder à users via Microsoft Graph de deux façons :You can access users through Microsoft Graph in two ways:

  • par leur ID, /users/{id | userPrincipalName} ;By their ID, /users/{id | userPrincipalName}
  • à l’aide de l’alias /me pour l’utilisateur connecté, qui est le même que /users/{signed-in user's id} ;By using the /me alias for the signed-in user, which is the same as /users/{signed-in user's id}

AutorisationAuthorization

L’une des autorisations suivantes est requise pour accéder aux opérations de l’utilisateur. Les trois premières autorisations peuvent être octroyées à une application par un utilisateur. Les autres peuvent être octroyées à une application par l’administrateur uniquement.One of the following permissions is required to access user operations. The first three permissions can be granted to an app by a user. The rest can only be granted to an app by the administrator.

  • User.ReadBasic.AllUser.ReadBasic.All
  • User.ReadUser.Read
  • User.ReadWriteUser.ReadWrite
  • User.Read.AllUser.Read.All
  • User.ReadWrite.AllUser.ReadWrite.All
  • Directory.Read.AllDirectory.Read.All
  • Directory.ReadWrite.AllDirectory.ReadWrite.All
  • Directory.AccessAsUser.AllDirectory.AccessAsUser.All

Propriétés courantesCommon properties

Les éléments suivants représentent l’ensemble par défaut des propriétés qui sont renvoyées lorsque vous obtenez un utilisateur ou répertoriez des utilisateurs.The following represent the default set of properties that are returned when getting a user or listing users. Il s’agit d’un sous-ensemble de toutes les propriétés disponibles.These are a subset of all available properties. Pour obtenir davantage de propriétés utilisateur, utilisez le paramètre de requête $select.To get more user properties, use the $select query parameter.

PropriétéProperty DescriptionDescription
idid Identificateur unique de l’utilisateur.The unique identifier for the user.
businessPhonesbusinessPhones Numéros de téléphone de l’utilisateur.The user's phone numbers.
displayNamedisplayName Nom affiché dans le carnet d’adresses de l’utilisateur.The name displayed in the address book for the user.
givenNamegivenName Prénom de l’utilisateur.The first name of the user.
jobTitlejobTitle Fonction de l’utilisateur.The user's job title.
mailmail Adresse de messagerie de l’utilisateur.The user's email address.
mobilePhonemobilePhone Numéro de téléphone portable de l’utilisateur.The user's cellphone number.
officeLocationofficeLocation Emplacement physique du bureau de l’utilisateur.The user's physical office location.
preferredLanguagepreferredLanguage Langue préférée de l’utilisateur.The user's language of preference.
surnamesurname Nom de l’utilisateur.The last name of the user.
userPrincipalNameuserPrincipalName Nom principal de l’utilisateur.The user's principal name.

Pour plus d’informations et pour obtenir une liste de toutes les propriétés, consultez l’objet user.For details and a list of all the properties, see the user object.

Opérations courantesCommon operations

Remarque : Certaines de ces opérations nécessitent des autorisations supplémentaires.Note: Some of these operations require additional permissions.

PathPath DescriptionDescription
/users Répertorie les utilisateurs de l’organisation.Lists users in the organization.
/users/{id} Obtient un utilisateur spécifique par ID.Gets a specific user by id.
/users/{id}/photo/$value Obtient la photo de profil de l’utilisateur.Gets the user's profile photo.
/users/{id}/manager Obtient le responsable de l’utilisateur.Gets the user's manager.
/users/{id}/messages Répertorie les messages de courrier électronique de l’utilisateur dans sa boîte de réception principale.Lists the user's email messages in their primary inbox.
/users/{id}/events Répertorie les événements à venir de l’utilisateur dans son calendrier.Lists the user's upcoming events in their calendar.
/users/{id}/drive Obtient un stockage de fichiers OneDrive de l’utilisateur.Gets the user's OneDrive file store.
/users/{id}/memberOf Répertorie les groupes dont l’utilisateur est membre.Lists the groups that the user is a member of.