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"
}