联系人资源类型

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

该资源支持:

  • 使用扩展将自己的数据添加到自定义属性。
  • 通过提供 delta 函数使用增量查询跟踪增量添加、删除和更新。

方法

方法 返回类型 说明
获取联系人 联系人 读取 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'
部门 String 联系人所在的部门。
displayName String 联系人的显示名称。
emailAddresses EmailAddress 集合 联系人的电子邮件地址。
fileAs String 联系人备案的姓名。
generation String 联系人所属的代。
givenName String 联系人的名。
homeAddress PhysicalAddress 联系人的住宅地址。
homePhones String collection 联系人的住宅电话号码。
id String 联系人的唯一标识符。只读。
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 集合 为联系人定义的单值扩展属性的集合。只读。可为 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",
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string",

  "photo": { "@odata.type": "microsoft.graph.profilePhoto" }
}

另请参阅