Répertorier les objets directReportsList directReports

Espace de noms: microsoft.graphNamespace: microsoft.graph

Obtenir les collaborateurs directs d’un utilisateur.Get a user's direct reports.

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.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllUser.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) Non pris en chargeNot supported
ApplicationApplication User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.AllUser.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

Lorsqu’une application interroge une relation qui renvoie une collection de type directoryObject, si elle n’a pas l’autorisation de lire un certain type dérivé (tel que l’appareil), les membres de ce type sont renvoyés, mais avec une information limitée.When an application queries a relationship that returns a directoryObject type collection, if it does not have permission to read a certain derived type (like device), members of that type are returned but with limited information. Avec ces applications comportementales, les applications peuvent demander les autorisations minimales dont elles ont besoin, plutôt que de s’appuyer sur l’accès aux autorisations.With this behaviour applications can request the least privileged permissions they need, rather than rely on the set of Directory.* permissions. Pour plus d’informations, consultez Informations limitées retournées pour les objets membres inaccessibles.For details, see Limited information returned for inaccessible member objects.

Requête HTTPHTTP request

GET /me/directReports
GET /users/{id | userPrincipalName}/directReports

Paramètres facultatifs de la 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.

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 une collection d’objets directoryObject dans le corps de la réponse.If successful, this method returns a 200 OK response code and a collection of directoryObject objects in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/directReports

RéponseResponse

Voici un exemple de réponse.Here is an example of the response.

Remarque : il se peut que l’objet de réponse illustré ici soit raccourci pour plus de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 55

{
  "value": [
    {
      "id": "id-value"
    }
  ]
}