Тип ресурса contactcontact 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 contactcontact Считывание свойств и отношений объекта contact.Read properties and relationships of contact object.
СозданиеCreate contactcontact Добавление контакта в корневую папку с контактами или конечную точку контактов другой папки с контактами.Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.
ОбновлениеUpdate contactcontact Обновление объекта contact.Update contact object.
УдалениеDelete НетNone Удаление объекта contact.Delete contact object.
deltadelta Коллекция contactcontact 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 Коллекция openTypeExtensionopenTypeExtension 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 contactcontact Создание одного или нескольких расширенных свойств с одним значением в новом или существующем контакте.Create one or more single-value extended properties in a new or existing contact.
Получение контакта с расширенным свойством с одним значениемGet contact with single-value extended property contactcontact Получение контактов, которые содержат расширенное свойство с одним значением, при помощи $expand или $filter.Get contacts that contain a single-value extended property by using $expand or $filter.
Создание расширенного свойства с несколькими значениямиCreate multi-value extended property contactcontact Создание одного или нескольких расширенных свойств с несколькими значениями в новом или существующем контакте.Create one or more multi-value extended properties in a new or existing contact.
Получение контакта с расширенным свойством с несколькими значениямиGet contact with multi-value extended property contactcontact Получение контакта, который содержит расширенное свойство с несколькими значениями, при помощи $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 Дата рождения контакта. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате 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 Коллекция StringString collection Рабочие номера телефонов контакта.The contact's business phone numbers.
categoriescategories Коллекция StringString collection Категории, связанные с контактом.The categories associated with the contact.
changeKeychangeKey СтрокаString Указывает версию контакта. При каждом изменении контакта также меняется значение 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 Коллекция StringString collection Имена детей контакта.The names of the contact's children.
companyNamecompanyName StringString Название компании контакта.The name of the contact's company.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Время создания контакта. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате 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. Обратите внимание, что последующие обновления других свойств могут привести к тому, что автоматически созданное значение перезапишет указанное значение displayName.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 Коллекция EmailAddressEmailAddress 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 Коллекция StringString collection Номера домашних телефонов контакта.The contact's home phone numbers.
idid StringString Уникальный идентификатор контакта. Только для чтения.The contact's unique identifier. Read-only.
imAddressesimAddresses Коллекция StringString collection Адреса контакта для обмена мгновенными сообщениями.The contact's instant messaging (IM) addresses.
initialsinitials StringString Инициалы контакта.The contact's initials.
jobTitlejobTitle StringString Должность контакта.The contact’s job title.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Время изменения контакта. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате 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 Идентификатор родительской папки контакта.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.

ОтношенияRelationships

ОтношениеRelationship ТипType ОписаниеDescription
extensionsextensions Коллекция extensionextension collection Коллекция открытых расширений, определенных для контакта. Только для чтения. Допускается значение null.The collection of open extensions defined for the contact. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties Коллекция multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection Коллекция расширенных свойств с несколькими значениями, определенных для контакта. Только для чтения. Допускается значение null.The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
Фотография
photo profilePhotoprofilePhoto Необязательное фото контакта. Можно получить или задать фото для контакта.Optional contact picture. You can get or set a photo for a contact.
singleValueExtendedPropertiessingleValueExtendedProperties Коллекция singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection Коллекция расширенных свойств с одним значением, определенных для контакта. Только для чтения. Допускается значение null.The collection of single-value extended properties defined for the contact. Read-only. Nullable.

Представление JSONJSON 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