person 资源类型person resource type

邮件、联系人和社交网络中关于某个人员的信息聚合。人员可以是当地联系人、社交网络或你所在组织目录中的联系人以及来自最近通信(例如电子邮件和 Skype)的人员。An aggregation of information about a person from across mail, contacts, and social networks. People can be local contacts, contacts from social networking or your organization's directory, and people from recent communications (such as email and Skype).


方法Method 返回类型Return Type 说明Description
List peopleList people personperson 获取按与用户的相关性排序的人员对象集合。Get a collection of person objects ordered by their relevance to the user.


属性Property 类型Type 说明Description
birthdaybirthday StringString 人员的生日。The person's birthday.
companyNamecompanyName StringString 人员的公司名称。The name of the person's company.
departmentdepartment StringString 人员的部门。The person's department.
displayNamedisplayName StringString 人员的显示名称。The person's display name.
scoredEmailAddressesscoredEmailAddresses scoredEmailAddress collectionscoredEmailAddress collection 人员的电子邮件地址。The person's email addresses.
givenNamegivenName StringString 人员的名字。The person's given name.
idid 字符串String 人员的唯一标识符。只读。The person's unique identifier. Read-only.
imAddressimAddress StringString 用户的即时消息 IP 语音 (VOIP) 会话初始协议 (SIP) 地址。只读。The instant message voice over IP (VOIP) session initiation protocol (SIP) address for the user. Read-only.
isFavoriteisFavorite BooleanBoolean 如果用户已将此人员标记为常用联系人,则为 truetrue if the user has flagged this person as a favorite.
jobTitlejobTitle StringString 人员的职务。The person's job title.
officeLocationofficeLocation StringString 人员的办公室位置。The location of the person's office.
personNotespersonNotes StringString 用户对此人员所做的自由格式备注。Free-form notes that the user has taken about this person.
personTypepersonType personTypepersonType 人员类型。The type of person.
phonesphones phone collectionphone collection 人员的电话号码。The person's phone numbers.
postalAddressespostalAddresses location collectionlocation collection 人员的地址。The person's addresses.
professionprofession StringString 人员的职业。The person's profession.
surnamesurname StringString 人员的姓氏。The person's surname.
userPrincipalNameuserPrincipalName 字符串String 人员的用户主体名称 (UPN)。UPN 是人员基于 Internet 标准 RFC 822 的 Internet 式登录名。按照惯例,此名称应映射到人员的电子邮件名称。常规格式为:别名@域。The user principal name (UPN) of the person. The UPN is an Internet-style login name for the person based on the Internet standard RFC 822. By convention, this should map to the person's email name. The general format is alias@domain.
websiteswebsites website collectionwebsite collection 人员的网站。The person's websites.
yomiCompanyyomiCompany StringString 人员所在公司的注音日文名称。The phonetic Japanese name of the person's company.



JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。The following is a JSON representation of the resource.

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