person 资源类型

命名空间：microsoft.graph

重要

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

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

方法

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

属性

属性	类型	说明
birthday	String	人员的生日。
companyName	String	人员的公司名称。
department	String	人员的部门。
displayName	String	人员的显示名称。
emailAddresses	rankedEmailAddress 集合	人员的电子邮件地址。
givenName	String	人员的名字。
id	字符串	人员的唯一标识符。 此为只读属性。
isFavorite	Boolean	如果用户已将此人员标记为常用联系人，则为 True。
mailboxType	String	由人员的电子邮件地址表示的邮箱类型。
officeLocation	String	人员的办公室位置。
personNotes	String	用户对此人员所做的自由格式备注。
personType	String	人员类型，例如通讯组列表。
phones	phone collection	人员的电话号码。
postalAddresses	location collection	人员的地址。
profession	String	人员的职业。
源	personDataSource 集合	用户数据的来源，例如 Directory 或 Outlook 联系人。
surname	String	人员的姓氏。
title	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",
  "emailAddresses": [{"@odata.type": "microsoft.graph.rankedEmailAddress"}],
  "givenName": "String",
  "id": "String (identifier)",
  "isFavorite": "Boolean",
  "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"
}