person 资源类型

命名空间：microsoft.graph

表示邮件和联系人中有关人员的信息的聚合。 人员可以是本地联系人或组织的目录，以及来自最近通信 (的人员，例如电子邮件) 。

方法

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

属性

属性	类型	说明
birthday	String	人员的生日。
companyName	String	人员的公司名称。
department	String	人员的部门。
displayName	String	人员的显示名称。
givenName	String	人员的名字。
id	字符串	人员的唯一标识符。 此为只读属性。
imAddress	String	即时消息语音基于 IP (VOIP) 会话启动协议 (用户的 SIP) 地址。 此为只读属性。
isFavorite	Boolean	如果用户已将此人员标记为常用联系人，则为 True。
jobTitle	String	人员的职务。
officeLocation	String	人员的办公室位置。
personNotes	String	用户对此人员所做的自由格式备注。
personType	personType	人员类型。
phones	phone collection	人员的电话号码。
postalAddresses	location collection	人员的地址。
profession	String	人员的职业。
scoredEmailAddresses	scoredEmailAddress collection	人员的电子邮件地址。
surname	String	人员的姓氏。
userPrincipalName	字符串	用户主体名称 (用户的 UPN) 。 UPN 是基于 Internet 标准 RFC 822 的人员的 Internet 样式登录名。 按照约定，这应映射到此人的电子邮件名称。 常规格式为alias@domain。
websites	website collection	人员的网站。
yomiCompany	String	人员所在公司的注音日文名称。

Relationships

无。

JSON 表示形式

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

{
  "birthday": "String",
  "companyName": "String",
  "department": "String",
  "displayName": "String",
  "scoredEmailAddresses": [{"@odata.type": "microsoft.graph.scoredEmailAddress"}],
  "givenName": "String",
  "id": "String (identifier)",
  "imAddress": "String",
  "isFavorite": "Boolean",
  "jobTitle": "String",
  "officeLocation": "String",
  "personNotes": "String",
  "personType": {"@odata.type": "microsoft.graph.personType"},
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.location"}],
  "profession": "String",
  "surname": "String",
  "userPrincipalName": "String",
  "websites": [{"@odata.type": "microsoft.graph.website"}],
  "yomiCompany": "String"
}