大网数据广告活动
Microsoft Graph 接口

在 Microsoft Graph 中与用户一起工作

· 52CE 我爱测

构建基于用户、用户与其他用户和组的关系、用户邮件、日历和文件且有说服力的应用体验。

可以使用 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 用户的职务。
mail 用户的电子邮件地址。
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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。