列出 directReports

命名空间:microsoft.graph

获取用户的直接下属。 返回指定此用户作为经理的用户和联系人。 此 API 不支持获取指定用户的直接下属之外的直接报表链。

此 API 可用于以下国家级云部署

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) User.Read 和 User.ReadBasic.All Directory.ReadWrite.All、Directory.Read.All、User.ReadWrite.All、User.Read.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
Application User.Read.All User.ReadWrite.All、Directory.Read.All、Directory.ReadWrite.All

重要

当应用程序查询返回 directoryObject 类型集合的关系时,如果它没有读取特定资源类型的权限,则会返回该类型的成员,但信息有限。 例如,仅返回对象类型和 ID@odata.type 属性,而其他属性则指示为 null。 通过此行为,应用程序可以请求所需的最低特权权限,而不是依赖于 目录集。*权限。 有关详细信息,请参阅为不可访问的成员对象返回有限的信息

HTTP 请求

检索用户的直接下属:

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

若要检索用户及其直接下属,请使用 $expand 查询参数:

注意$expand 最多返回 20 个对象。 有关详细信息,请参阅 查询参数限制

GET /me?$expand=directReports
GET /users/{id | userPrincipalName}?$expand=directReports

可选的查询参数

此方法支持 $select$count$expand$filterOData 查询参数 来帮助自定义响应。 可以使用 $select 表达式中的 $expand 嵌套。 例如,me?$expand=($select=id,displayName)。 只有将 ConsistencyLevel 标头设置为 eventual$count 时,才支持某些查询。 有关详细信息,请参阅 目录对象的高级查询功能

请求标头

标头
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权
Content-Type application/json
ConsistencyLevel 最终。 当使用 $search$filter 的特定用法时,需要此标头和 $count。 有关使用 ConsistencyLevel$count的详细信息,请参阅 目录对象的高级查询功能

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此方法会在响应正文中返回 200 OK 响应代码和 directoryObject 对象集合。

示例

请求

以下示例显示了一个请求。

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

响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#directoryObjects",
    "value": [
        {
            "@odata.type": "#microsoft.graph.user",
            "id": "6ea91a8d-e32e-41a1-b7bd-d2d185eed0e0",
            "businessPhones": [],
            "displayName": "Conf Room Adams",
            "givenName": null,
            "jobTitle": null,
            "mail": "Adams@contoso.com",
            "mobilePhone": null,
            "officeLocation": null,
            "preferredLanguage": null,
            "surname": null,
            "userPrincipalName": "Adams@contoso.com"
        }
    ]
}