联系人资源类型

命名空间:microsoft.graph

联系人是 Outlook 中的一个项目,你可以在这里组织和保存有关你通信的人员和组织的信息。 联系人包含在联系人文件夹中。

该资源支持:

方法

方法 返回类型 说明
获取联系人 联系人 读取 contact 对象的属性和关系。
创建联系人 联系人 将联系人添加到联系人根文件夹或其他联系人文件夹的联系人端点中。
更新联系人 联系人 更新 contact 对象。
删除联系人 删除 contact 对象。
获取联系人 Delta 联系人集合 获取指定文件夹中已添加、删除或更新的联系人集。
开放扩展
创建开放扩展 openTypeExtension 创建开放扩展,并在新建或现有的资源实例中添加自定义属性。
获取开放扩展 openTypeExtension 集合 获取通过名称或完全限定的名称识别的一个或多个开放扩展对象。
扩展属性
创建单值属性 联系人 在新建或现有的联系人中创建一个或多个单值扩展属性。
获取单值属性 联系人 通过使用 $expand$filter 获取包含一个单值扩展属性的联系人。
创建多值属性 联系人 在新建或现有的联系人中创建一个或多个多值扩展属性。
获取多值属性 联系人 使用 $expand 获取包含一个多值扩展属性的联系人。

属性

属性 类型 说明
assistantName String 联系人助理的姓名。
birthday DateTimeOffset 联系人的生日。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
businessAddress PhysicalAddress 联系人的公司地址。
businessHomePage String 联系人的公司主页。
businessPhones String collection 联系人的公司电话号码。
categories String collection 与联系人关联的类别。
changeKey String 标识联系人的版本。 每次联系人更改时,ChangeKey 也将更改。 这样,Exchange 可以将更改应用于该对象的正确版本。
children String collection 联系人子女的姓名。
CompanyName String 联系人所在公司的名称。
createdDateTime DateTimeOffset 创建联系人的时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
department String 联系人所在的部门。
displayName String 联系人的显示名称。 可以在创建更新操作中指定显示名称。 请注意,对其他属性的后续更新可能会导致自动生成的值覆盖你指定的 displayName 值。 若要保留预先存在的值,请始终在更新操作中将其作为 displayName。
emailAddresses EmailAddress 集合 联系人的电子邮件地址。
fileAs String 联系人备案的姓名。
generation String 联系人的后缀。
givenName String 联系人的名。
homeAddress PhysicalAddress 联系人的住宅地址。
homePhones String collection 联系人的住宅电话号码。
id String 联系人的唯一标识符。 默认情况下,当项从一个容器(如文件夹或日历)移动到另一个容器时,此值会更改。 若要更改此行为,请使用 Prefer: IdType="ImmutableId"头。 有关详细信息,请参阅获取 Outlook 资源的不可变标识符。 此为只读属性。
imAddresses String collection 联系人的即时消息 (IM) 地址。
initials String 联系人的姓名缩写。
jobTitle String 联系人的职务。
lastModifiedDateTime DateTimeOffset 修改联系人的时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
manager String 联系人经理的姓名。
middleName String 联系人的中间名。
mobilePhone String 联系人的移动电话号码。
nickName String 联系人的昵称。
officeLocation String 联系人的办公室位置。
otherAddress PhysicalAddress 联系人的其他地址。
parentFolderId String 联系人的父文件夹 ID。
personalNotes String 有关联系人的用户备注。
profession String 联系人的职业。
spouseName String 联系人配偶/伴侣的姓名。
surname String 联系人的姓氏。
title String 联系人的职位。
yomiCompanyName String 联系人的注音日文公司名称。
yomiGivenName String 联系人的注音日文名字。
yomiSurname String 日语拼音姓氏 (联系人) 。

关系

关系 类型 说明
extensions 扩展集合 为联系人定义的开放扩展集合。 只读。 可为 Null。
multiValueExtendedProperties multiValueLegacyExtendedProperty 集合 为联系人定义的多值扩展属性的集合。 只读。 可为 NULL。
photo profilePhoto 可选的联系人照片。 可以获取或设置联系人的照片。
singleValueExtendedProperties singleValueLegacyExtendedProperty collection 为联系人定义的单值扩展属性的集合。 只读。 可为 Null。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "assistantName": "string",
  "birthday": "String (timestamp)",
  "businessAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "businessHomePage": "string",
  "businessPhones": ["string"],
  "categories": ["string"],
  "changeKey": "string",
  "children": ["string"],
  "companyName": "string",
  "createdDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.emailAddress"}],
  "fileAs": "string",
  "generation": "string",
  "givenName": "string",
  "homeAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "homePhones": ["string"],
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "initials": "string",
  "jobTitle": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "manager": "string",
  "middleName": "string",
  "mobilePhone": "string",
  "nickName": "string",
  "officeLocation": "string",
  "otherAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "parentFolderId": "string",
  "personalNotes": "string",
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}