Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Возвращает пользователя или контакт организации, назначенный в качестве руководителя пользователя. Кроме того, вы можете развернуть цепочку руководителей до корневого узла.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | User.Read.All | Directory.Read.All, Directory.ReadWrite.All, User.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Не поддерживается. | Не поддерживается. |
Важно!
Когда приложение запрашивает связь, которая возвращает коллекцию типов directoryObject , если у него нет разрешения на чтение определенного типа ресурсов, возвращаются члены этого типа, но с ограниченной информацией. Например, возвращается только свойство @odata.type для типа объекта и идентификатор , в то время как другие свойства указываются как null
. При таком поведении приложения могут запрашивать необходимые разрешения с наименьшими привилегиями, а не полагаться на набор каталогов.*Разрешения. Сведения см. в разделе Ограниченные сведения, возвращаемые для недоступных объектов member.
HTTP-запрос
Получение руководителя:
GET /me/manager
GET /users/{id | userPrincipalName}/manager
Примечание.
Для вызова конечной точки /me
требуется вход пользователя и, следовательно, делегированное разрешение. Разрешения приложений не поддерживаются при использовании конечной /me
точки.
Получение цепочки управления:
GET /users?$expand=manager
GET /users/{id | userPrincipalName}/?$expand=manager($levels=n)
Необязательные параметры запросов
Этот метод поддерживает $select
параметры запроса OData и $expand
для настройки ответа. При использовании $expand
параметра запроса:
- Значение
n
параметра$levels
может бытьmax
(для возврата всех руководителей) или числом от 1 до 1000. - Если параметр
$levels
не указан, возвращается только непосредственный руководитель. - Вы можете указать
$select
внутри$expand
, чтобы выбрать свойства отдельного руководителя:$expand=manager($levels=max;$select=id,displayName)
. -
$levels
параметр поддерживается только для одного пользователя (/users/{id}
илиme
конечных точек), а не для всего списка пользователей. -
$levels
Для использования требуется, чтобы для заголовка ConsistencyLevel было задано значениеeventual
. Дополнительные сведения об использовании ConsistencyLevel см. в разделе Расширенные возможности запросов к объектам каталога.
Заголовки запросов
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
ConsistencyLevel | необязательный. Требуется, если запрос включает $levels=n в $expand параметр запроса . |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
При успешном выполнении этот метод возвращает код отклика 200 OK
и объект user в теле отклика. Если пользователю не назначен менеджер, этот метод возвращает 404 Not Found
код ошибки.
Примеры
Пример 1. Получение руководителя
Ниже показан пример запроса для получения руководителя.
Запрос
GET https://graph.microsoft.com/beta/users/{id|userPrincipalName}/manager
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "7d54cb02-aaa3-4016-9f9c-a4b49422dd9b",
"displayName": "Sara Davis",
"jobTitle": "Finance VP",
"mail": "[email protected]",
"userPrincipalName": "[email protected]"
}
Пример 2. Получение цепочкой руководителей до корневого уровня
Ниже показан пример запроса для получения цепочки руководителей до корневого уровня.
Запрос
GET https://graph.microsoft.com/beta/me?$expand=manager($levels=max;$select=id,displayName)&$select=id,displayName
ConsistencyLevel: eventual
Отклик
Ниже показан пример отклика. Промежуточные руководители отображаются иерархически.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
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"
}
}
}
}