Lire en anglais

Partager via


Répertorier le responsable

Espace de noms: microsoft.graph

Renvoie l’utilisateur ou le contact de l’organisation affecté en tant que responsable de l’utilisateur. Vous pouvez éventuellement développer la chaîne du responsable jusqu’au nœud racine.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) User.Read.All Directory.Read.All, Directory.ReadWrite.All, User.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Non prise en charge. Non prise en charge.

Important

Lorsqu’une application interroge une relation qui retourne une collection de types directoryObject , si elle n’a pas l’autorisation de lire un certain type de ressource, les membres de ce type sont retournés, mais avec des informations limitées. Par exemple, seule la propriété @odata.type pour le type d’objet et l’ID est retournée, tandis que les autres propriétés sont indiquées comme null. Avec ce comportement, les applications peuvent demander les autorisations les moins privilégiées dont elles ont besoin, plutôt que de s’appuyer sur l’ensemble de Répertoire.*Autorisations. Pour plus d’informations, consultez Informations limitées retournées pour les objets membres inaccessibles.

Requête HTTP

Obtenir le responsable :

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

Obtenir la chaîne de gestion :

GET /users?$expand=manager
GET /users/{id | userPrincipalName}/?$expand=manager($levels=n)

Paramètres facultatifs de la requête

Cette méthode prend en charge les paramètres de requête $select et $expandOData pour aider à personnaliser la réponse. Lors de l’utilisation du $expand paramètre de requête :

  • La valeur n de $levels peut être max (pour retourner tous les gestionnaires) ou un nombre compris entre 1 et 1 000.
  • Lorsque le paramètre $levels n’est pas spécifié, seul le gestionnaire immédiat est retourné.
  • Vous pouvez spécifier $select à l’intérieur $expand pour sélectionner les propriétés du gestionnaire individuel : $expand=manager($levels=max;$select=id,displayName).
  • $levels Le paramètre est pris en charge uniquement sur un seul utilisateur (/users/{id} ou me des points de terminaison) et non sur la liste complète des utilisateurs.
  • L’utilisation de $levels nécessite que l’en-tête ConsistencyLevel soit défini sur eventual. Pour plus d’informations sur l’utilisation de ConsistencyLevel, consultez Fonctionnalités de requête avancées sur les objets d’annuaire.

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
ConsistencyLevel éventuellement. Obligatoire lorsque la requête inclut dans $levels=n le paramètre de $expand requête.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

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. Si aucun responsable n’est affecté à l’utilisateur, cette méthode retourne un 404 Not Found code d’erreur.

Exemples

Exemple 1 : obtenir le responsable

L’exemple suivant représente une demande pour obtenir le responsable.

Demande

GET https://graph.microsoft.com/v1.0/users/{id|userPrincipalName}/manager

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ici peut être raccourci pour plus de lisibilité.

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

{
  "id": "7d54cb02-aaa3-4016-9f9c-a4b49422dd9b",
  "displayName": "Sara Davis",
  "jobTitle": "Finance VP",
  "mail": "SaraD@contoso.com",
  "userPrincipalName": "SaraD@contoso.com"
}

Exemple 2 : obtenir une chaîne de responsable jusqu’au niveau racine

L’exemple suivant représente une demande pour obtenir la chaîne du responsable au niveau de la racine.

Demande

GET https://graph.microsoft.com/v1.0/me?$expand=manager($levels=max;$select=id,displayName)&$select=id,displayName
ConsistencyLevel: eventual

Réponse

L’exemple suivant illustre la réponse. Les gestionnaires transitifs sont affichés de façon hiérarchique.

Remarque : l’objet de réponse affiché ici peut être raccourci pour plus de lisibilité.

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

{
  "id": "a97733ce-92a4-4e7e-8d45-8e1f3e6a69d8",
  "displayName": "Individual Contributor",
  "manager": {
    "id": "7d54cb02-aaa3-4016-9f9c-a4b49422dd9b",
    "displayName": "Alex Wilber",
    "manager": {
      "id": "343a3f95-377c-47a9-b697-480487bfcdf7",
      "displayName": "Bianca Pisani",
      "manager": {
        "id": "8e07b731-5ba7-4081-b482-15e6eca35c45",
        "displayName": "Patti Fernandez"
      }
    }
  }
}