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 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
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.
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)
Cette méthode prend en charge les paramètres de requête $select
et $expand
OData pour aider à personnaliser la réponse. Lors de l’utilisation du $expand
paramètre de requête :
- La valeur
n
de$levels
peut êtremax
(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}
oume
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 sureventual
. Pour plus d’informations sur l’utilisation de ConsistencyLevel, consultez Fonctionnalités de requête avancées sur les objets d’annuaire.
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. |
N’indiquez pas le corps de la demande pour cette méthode.
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.
L’exemple suivant représente une demande pour obtenir le responsable.
GET https://graph.microsoft.com/v1.0/users/{id|userPrincipalName}/manager
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"
}
L’exemple suivant représente une demande pour obtenir la chaîne du responsable au niveau de la racine.
GET https://graph.microsoft.com/v1.0/me?$expand=manager($levels=max;$select=id,displayName)&$select=id,displayName
ConsistencyLevel: eventual
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"
}
}
}
}