Contact.personname 资源类型

命名空间：microsoft.graph

重要

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

代表用户提供的、与其在 配置文件中关联的扩展名称信息。

继承自 itemFacet。

方法

方法	返回类型	说明
列出名称	contact.personname 集合	从 "名称" 导航属性中获取 Contact.personname 资源。
创建 Contact.personname	Contact.personname	从 "名称" 导航属性中创建一个新的 contact.personname 对象。
获取 Contact.personname	Contact.personname	读取 contact.personname 对象的属性和关系。
更新 Contact.personname	Contact.personname	更新 contact.personname 对象的属性。
删除 Contact.personname	无	删除一个 contact.personname 对象。

属性

属性	类型	说明
allowedAudiences	String	能够查看实体中包含的值的访问群体。 继承自 itemFacet。 可取值为：me、family、contacts、groupMembers、organization、federatedOrganizations、everyone、unknownFutureValue。
createdBy	identitySet	提供创建实体的用户和/或应用程序的标识符。 继承自 itemFacet。
createdDateTime	DateTimeOffset	为创建实体时提供 dateTimeOffset。 继承自 itemFacet。
displayName	String	根据用户或其设备的区域设置，提供 firstName 和 lastName 的顺序呈现。
前	String	用户的名字。
id	String	用于单独寻址实体的标识符。 继承自 entity
推导	inferenceData	如果实体是由创建或修改应用程序推断的，则包含推理详细信息。 继承自 itemFacet。
initials	String	用户的首字母缩写。
languageTag	String	包含以下语言的名称： (en-us、无 NB、en-us) 以下 IETF BCP47 格式。
末	String	用户的姓氏。
lastModifiedBy	identitySet	提供上次修改实体的用户和/或应用程序的标识符。 继承自 itemFacet。
lastModifiedDateTime	DateTimeOffset	为创建实体时提供 dateTimeOffset。 继承自 itemFacet。
maiden	String	Maiden 用户的名称。
中间	String	用户的中间名。
昵称	String	用户的昵称。
拼音	yomiPersonName	有关如何对用户名称进行发音的指南。
source	personDataSource	值的来源，如果从另一个服务同步。 继承自 itemFacet。
后缀	String	用户名称之后使用的指示符 (例如：博士. )
title	String	Honorifics 用于为用户名称加上前缀 (例如： Dr.、罗德、Madam、Mrs )

关系

无。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.personName",
  "id": "e13f7a4d-303c-464f-a6af-80ea18eb74f3",
  "allowedAudiences": "organization",
  "inference": {
    "@odata.type": "microsoft.graph.inferenceData"
  },
  "createdDateTime": "2020-07-06T06:34:12.2294868Z",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "source": {
    "@odata.type": "microsoft.graph.personDataSource"
  },
  "displayName": "Innocenty Popov",
  "first": "Innocenty",
  "initials": "IP",
  "last": "Popov",
  "languageTag": "en-US",
  "maiden": null,
  "middle": null,
  "nickname": "Kesha",
  "suffix": null,
  "title": null,
  "pronunciation": {
    "@odata.type": "microsoft.graph.yomiPersonName"
  }
}