联系人资源类型contact resource type

联系人是 Outlook 中的一个项目,你可以在这里组织和保存有关你通信的人员和组织的信息。联系人包含在联系人文件夹中。A contact is an item in Outlook where you can organize and save information about the people and organizations you communicate with. Contacts are contained in contact folders.

该资源支持:This resource supports:

方法Methods

方法Method 返回类型Return Type 说明Description
获取联系人Get contact 联系人contact 读取 contact 对象的属性和关系。Read properties and relationships of contact object.
创建Create 联系人contact 将联系人添加到联系人根文件夹或其他联系人文件夹的联系人端点中。Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.
更新Update 联系人contact 更新 contact 对象。Update contact object.
删除Delete None 删除 contact 对象。Delete contact object.
deltadelta 联系人集合contact collection 获取指定文件夹中已添加、删除或更新的联系人集。Get a set of contacts that have been added, deleted, or updated in a specified folder.
开放扩展Open extensions
创建开放扩展Create open extension openTypeExtensionopenTypeExtension 创建开放扩展,并在新建或现有的资源实例中添加自定义属性。Create an open extension and add custom properties in a new or existing instance of a resource.
获取开放扩展Get open extension openTypeExtension 集合openTypeExtension collection 获取通过名称或完全限定的名称识别的一个或多个开放扩展对象。Get an open extension object or objects identified by name or fully qualified name.
架构扩展Schema extensions
添加架构扩展值Add schema extension values 创建架构扩展定义,然后使用它向资源添加自定义键入数据。Create a schema extension definition and then use it to add custom typed data to a resource.
扩展属性Extended properties
创建单值扩展属性Create single-value extended property 联系人contact 在新建或现有的联系人中创建一个或多个单值扩展属性。Create one or more single-value extended properties in a new or existing contact.
获取具有单值扩展属性的联系人Get contact with single-value extended property 联系人contact 通过使用 $expand$filter 获取包含一个单值扩展属性的联系人。Get contacts that contain a single-value extended property by using $expand or $filter.
创建多值扩展属性Create multi-value extended property 联系人contact 在新建或现有的联系人中创建一个或多个多值扩展属性。Create one or more multi-value extended properties in a new or existing contact.
获取具有多值扩展属性的联系人Get contact with multi-value extended property 联系人contact 使用 $expand 获取包含一个多值扩展属性的联系人。Get a contact that contains a multi-value extended property by using $expand.

属性Properties

属性Property 类型Type 说明Description
assistantNameassistantName StringString 联系人助理的姓名。The name of the contact's assistant.
birthdaybirthday DateTimeOffsetDateTimeOffset 联系人的生日。时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 类似于如下形式:'2014-01-01T00:00:00Z'The contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
businessAddressbusinessAddress PhysicalAddressPhysicalAddress 联系人的公司地址。The contact's business address.
businessHomePagebusinessHomePage StringString 联系人的公司主页。The business home page of the contact.
businessPhonesbusinessPhones String collectionString collection 联系人的公司电话号码。The contact's business phone numbers.
categoriescategories String collectionString collection 与联系人关联的类别。The categories associated with the contact.
changeKeychangeKey StringString 标识联系人的版本。每次联系人更改时,ChangeKey 也将更改。这样,Exchange 可以将更改应用于该对象的正确版本。Identifies the version of the contact. Every time the contact is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
childrenchildren String collectionString collection 联系人子女的姓名。The names of the contact's children.
companyNamecompanyName StringString 联系人所在公司的名称。The name of the contact's company.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 创建联系人的时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 类似于如下形式:'2014-01-01T00:00:00Z'The time the contact was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
部门department StringString 联系人所在的部门。The contact's department.
displayNamedisplayName StringString 联系人的显示名称。The contact's display name. 您可以创建更新操作中指定的显示名称。You can specify the display name in a create or update operation. 请注意,以后对其他属性更新可能会导致自动生成的值覆盖已指定的显示名称值。Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. 若要保留现有的值,请始终作为更新操作中的 displayName 包括它。To preserve a pre-existing value, always include it as displayName in an update operation.
emailAddressesemailAddresses EmailAddress 集合EmailAddress collection 联系人的电子邮件地址。The contact's email addresses.
fileAsfileAs StringString 联系人备案的姓名。The name the contact is filed under.
generationgeneration StringString 联系人所属的代。The contact's generation.
givenNamegivenName StringString 联系人的名。The contact's given name.
homeAddresshomeAddress PhysicalAddressPhysicalAddress 联系人的住宅地址。The contact's home address.
homePhoneshomePhones String collectionString collection 联系人的住宅电话号码。The contact's home phone numbers.
idid StringString 联系人的唯一标识符。只读。The contact's unique identifier. Read-only.
imAddressesimAddresses String collectionString collection 联系人的即时消息 (IM) 地址。The contact's instant messaging (IM) addresses.
initialsinitials StringString 联系人的姓名缩写。The contact's initials.
jobTitlejobTitle StringString 联系人的职务。The contact’s job title.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset 修改联系人的时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 类似于如下形式:'2014-01-01T00:00:00Z'The time the contact was modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
managermanager StringString 联系人经理的姓名。The name of the contact's manager.
middleNamemiddleName StringString 联系人的中间名。The contact's middle name.
mobilePhonemobilePhone StringString 联系人的移动电话号码。The contact's mobile phone number.
nickNamenickName StringString 联系人的昵称。The contact's nickname.
officeLocationofficeLocation StringString 联系人的办公室位置。The location of the contact's office.
otherAddressotherAddress PhysicalAddressPhysicalAddress 联系人的其他地址。Other addresses for the contact.
parentFolderIdparentFolderId StringString 联系人的父文件夹 ID。The ID of the contact's parent folder.
personalNotespersonalNotes StringString 有关联系人的用户备注。The user's notes about the contact.
professionprofession StringString 联系人的职业。The contact's profession.
spouseNamespouseName StringString 联系人配偶/伴侣的姓名。The name of the contact's spouse/partner.
surnamesurname StringString 联系人的姓氏。The contact's surname.
titletitle StringString 联系人的职位。The contact's title.
yomiCompanyNameyomiCompanyName StringString 联系人的注音日文公司名称。The phonetic Japanese company name of the contact.
yomiGivenNameyomiGivenName StringString 联系人的注音日文名字。The phonetic Japanese given name (first name) of the contact.
yomiSurnameyomiSurname StringString 联系人的注音日文姓氏。The phonetic Japanese surname (last name) of the contact.

RelationshipsRelationships

关系Relationship 类型Type 说明Description
extensionsextensions 扩展集合extension collection 为联系人定义的开放扩展集合。只读。可为 Null。The collection of open extensions defined for the contact. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty 集合multiValueLegacyExtendedProperty collection 为联系人定义的多值扩展属性的集合。只读。可为 Null。The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
photophoto profilePhotoprofilePhoto 可选的联系人照片。可以获取或设置联系人的照片。Optional contact picture. You can get or set a photo for a contact.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty collectionsingleValueLegacyExtendedProperty collection 为联系人定义的单值扩展属性的集合。只读。可为 Null。The collection of single-value extended properties defined for the contact. Read-only. Nullable.

JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。Here is a JSON representation of the resource

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

另请参阅See also