person 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

有关来自邮件、联系人和社交网络的人员的信息聚合。用户可以是本地联系人、来自社交网络的联系人、组织的目录以及来自最近通信 (（如电子邮件和 Skype) ）的人员。

方法

方法	返回类型	说明
List people	person	获取按与用户的相关性排序的人员对象集合。

属性

属性	类型	说明
birthday	字符串	人员的生日。
companyName	字符串	人员的公司名称。
department	字符串	人员的部门。
displayName	string	人员的显示名称。
emailAddresses	rankedEmailAddress 集合	人员的电子邮件地址。
givenName	字符串	人员的名字。
id	string	人员的唯一标识符。只读。
isFavorite	boolean	如果用户已将此人员标记为常用联系人，则为 true。
mailboxType	字符串	由个人的电子邮件地址表示的邮箱类型。
officeLocation	字符串	人员的办公室位置。
personNotes	字符串	用户对此人员所做的自由格式备注。
personType	字符串	人员类型，例如通讯组列表。
phones	phone collection	人员的电话号码。
postalAddresses	location collection	人员的地址。
profession	字符串	人员的职业。
源	personDataSource 集合	用户数据来自的源，例如目录或 Outlook 联系人。
surname	字符串	人员的姓氏。
title	string	人员的职务。
userPrincipalName	string	人员的用户主体名称 (UPN)。UPN 是人员基于 Internet 标准 RFC 822 的 Internet 式登录名。按照惯例，此名称应映射到人员的电子邮件名称。常规格式为：别名@域。
websites	website collection	人员的网站。
yomiCompany	字符串	人员所在公司的注音日文名称。

关系

无

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "birthday": "string",
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.rankedEmailAddress"}],
  "givenName": "string",
  "id": "string (identifier)",
  "isFavorite": true,
  "mailboxType": "string",
  "officeLocation": "string",
  "personNotes": "string",
  "personType": "string",
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.location"}],
  "profession": "string",
  "sources": [{"@odata.type": "microsoft.graph.personDataSource"}],
  "surname": "string",
  "title": "string",
  "userPrincipalName": "string",
  "websites": [{"@odata.type": "microsoft.graph.website"}],
  "yomiCompany": "string"
}