可以使用 Microsoft Graph 基于用户、他们与其他用户和组的关系以及他们访问的资源(例如其邮件、日历、文件、管理角色、组成员身份)构建引人注目的应用体验。
通过 Microsoft Graph,你能以两种方式访问用户:
- 通过用户 ID,
/users/{id} - 通过使用已登录的用户的
/me别名,这与/users/{signed-in user's id}相同
Azure AD 中有两种类型的用户 - 成员用户和来宾用户。 来宾用户通过兑换其邀请加入组织。 来宾用户可以转换为成员,享受成员的所有特权。
授权
需要以下 权限 之一才能访问用户操作。用户可将前三个权限授予应用程序。其余权限只能由管理员授予应用。
- User.ReadBasic.All
- User.Read
- User.ReadWrite
- User.Read.All
- User.ReadWrite.All
- Directory.Read.All
- Directory.ReadWrite.All
- Directory.AccessAsUser.All
通用属性
以下内容表示获取或列出用户时返回的属性的默认集。 这些是所有可用属性的子集。 要获取更多用户属性,请使用 $select 查询参数。 了解如何使用 $select query 参数以及查看支持 $select query 参数的属性。
| 属性 | 说明 |
|---|---|
| id | 用户的唯一标识符。 |
| businessPhones | 用户的电话号码。 |
| displayName | 用户通讯簿中显示的名称。 |
| givenName | 用户的名 |
| jobTitle | 用户的职务。 |
| 用户的电子邮件地址。 | |
| mobilePhone | 用户的手机号码。 |
| officeLocation | 用户的办公地址。 |
| preferredLanguage | 用户的语言首选项。 |
| surname | 用户的姓。 |
| userPrincipalName | 用户主体名称。 |
有关详细信息及所有属性的列表,请参阅 user 对象。
组织中来宾用户的用户和组搜索限制
用户和组搜索功能允许应用对 /users 或 /groups 资源集(例如 https://graph.microsoft.com/v1.0/users)执行查询,以搜索组织目录中的任何用户或组。管理员和成员用户都具有此功能;但来宾用户没有。
如果登录用户是来宾用户,应用程序可以读取特定用户或组的配置文件(例如,https://graph.microsoft.com/v1.0/users/241f22af-f634-44c0-9a15-c8cd2cea5531),具体视应用程序获得的授权而定;不过,不能对可能返回多个资源的 /users 或 /groups 资源集执行查询。
借助授予的适当权限,应用程序可以读取用户或组的配置文件,具体是通过导航属性中的链接获取;例如,/users/{id}/directReports 或 /groups/{id}/members。
有关来宾用户搜索限制的详细信息,请参阅比较成员用户和来宾用户的默认权限。
通用操作
注意: 某些操作需要其他权限。
| 路径 | 说明 |
|---|---|
/users |
列出组织中的用户。 |
/users/{id} |
通过 ID 获取特定用户。 |
/users/{id}/photo/$value |
获取用户个人资料照片。 |
/users/{id}/manager |
获取用户的经理。 |
/users/{id}/messages |
列出用户主收件箱中的电子邮件。 |
/users/{id}/events |
列出用户日历中即将发生的事件。 |
/users/{id}/drive |
获取用户 OneDrive 文件存储。 |
/users/{id}/memberOf |
列出用户是其成员的所有组。 |
最近更新
了解此 API 集的最新功能和更新。
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 jpettere)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
