person 资源类型person resource type


Microsoft Graph 中/beta的版本下的 api 可能会发生更改。APIs under the /beta version in Microsoft Graph are subject to change. 不支持在生产应用程序中使用这些 API。Use of these APIs in production applications is not supported.

有关来自邮件、联系人和社交网络的人员的信息聚合。An aggregation of information about a person from across mail, contacts and social networks. 用户可以是本地联系人、来自社交网络的联系人、组织的目录以及来自最近通信 (例如电子邮件和 Skype) 的人员。People can be local contacts, contacts from social networking, 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.
emailAddressesemailAddresses rankedEmailAddress集合rankedEmailAddress collection 人员的电子邮件地址。The person's email addresses.
givenNamegivenName stringstring 人员的名字。The person's given name.
idid stringstring 人员的唯一标识符。只读。The person's unique identifier. Read-only.
isFavoriteisFavorite booleanboolean 如果用户已将此人员标记为常用联系人,则为 truetrue if the user has flagged this person as a favorite.
mailboxTypemailboxType stringstring 由个人的电子邮件地址表示的邮箱类型。The type of mailbox that is represented by the person's email address.
officeLocationofficeLocation stringstring 人员的办公室位置。The location of the person's office.
personNotespersonNotes stringstring 用户对此人员所做的自由格式备注。Free-form notes that the user has taken about this person.
personTypepersonType stringstring 人员类型, 例如通讯组列表。The type of person, for example distribution list.
phonesphones phone collectionphone collection 人员的电话号码。The person's phone numbers.
postalAddressespostalAddresses location collectionlocation collection 人员的地址。The person's addresses.
professionprofession stringstring 人员的职业。The person's profession.
sources personDataSource集合personDataSource collection 用户数据来自的源, 例如目录或 Outlook 联系人。The sources the user data comes from, for example Directory or Outlook Contacts.
surnamesurname stringstring 人员的姓氏。The person's surname.
titletitle stringstring 人员的职务。The person's title.
userPrincipalNameuserPrincipalName stringstring 人员的用户主体名称 (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 表示形式。Here is a JSON representation of the resource.

  "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": ""}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.location"}],
  "profession": "string",
  "sources": [{"@odata.type": "microsoft.graph.personDataSource"}],
  "surname": "string",
  "title": "string",
  "userPrincipalName": "string",
  "websites": [{"@odata.type": ""}],
  "yomiCompany": "string"