Поделиться через

Тип ресурса contact

  • Статья

Пространство имен: microsoft.graph

Контакт — элемент в Outlook, в котором вы можете упорядочить и хранить сведения о людях и организациях, с которыми поддерживаете связь. Контакты содержатся в папках контактов.

Этот ресурс поддерживает:

Методы

Метод Возвращаемый тип Описание
Получение контакта contact Считывание свойств и отношений объекта contact.
Создание контакта contact Добавление контакта в корневую папку с контактами или конечную точку контактов другой папки с контактами.
Обновление контакта contact Обновление объекта contact.
Удаление контакта Нет Удаление объекта contact.
Получение дельты контакта Коллекция contact Получение набора контактов, которые были добавлены в указанную папку, обновлены в ней или удалены из нее.
Открытые расширения
Создание открытого расширения openTypeExtension Создание открытого расширения и добавление настраиваемых свойств в новый или существующий экземпляр ресурса.
Получение открытого расширения Коллекция openTypeExtension Получение объекта или объектов открытого расширения, которые определяются по имени или полному имени.
Расширенные свойства
Создание однозначного свойства contact Создание одного или нескольких расширенных свойств с одним значением в новом или существующем контакте.
Получение однозначного свойства contact Получение контактов, которые содержат расширенное свойство с одним значением, при помощи $expand или $filter.
Создание свойства с несколькими значениями contact Создание одного или нескольких расширенных свойств с несколькими значениями в новом или существующем контакте.
Получение свойства с несколькими значениями contact Получение контакта, который содержит расширенное свойство с несколькими значениями, при помощи $expand.

Свойства

Свойство Тип Описание
assistantName String Имя помощника контакта.
birthday DateTimeOffset Дата рождения контакта. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
businessAddress PhysicalAddress Рабочий адрес контакта.
businessHomePage String Домашняя страница контакта (рабочая).
businessPhones Коллекция String Рабочие номера телефонов контакта.
categories Коллекция String Категории, связанные с контактом.
changeKey Строка Указывает версию контакта. При каждом изменении контакта также меняется значение ChangeKey. Благодаря этому Exchange может применять изменения к правильной версии объекта.
children Коллекция String Имена детей контакта.
CompanyName String Название компании контакта.
createdDateTime DateTimeOffset Время создания контакта. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
department String Отдел контакта.
displayName String Отображаемое имя контакта. Отображаемое имя можно указать в операции создания или обновления. Обратите внимание, что последующие обновления других свойств могут привести к тому, что автоматически созданное значение перезапишет указанное значение displayName. Чтобы сохранить существующее значение, всегда добавляйте его как displayName в операцию обновления.
emailAddresses Коллекция EmailAddress Электронные адреса контакта.
fileAs String Имя, под которым хранится контакт.
generation String Суффикс контакта.
givenName; String Имя контакта.
homeAddress PhysicalAddress Домашний адрес контакта.
homePhones Коллекция String Номера домашних телефонов контакта.
id String Уникальный идентификатор контакта. По умолчанию это значение изменяется при перемещении элемента из одного контейнера (например, папки или календаря) в другой. Чтобы изменить это поведение, используйте заголовок Prefer: IdType="ImmutableId". Дополнительные сведения см. в статье Получение неизменяемых идентификаторов для ресурсов Outlook. Только для чтения.
imAddresses Коллекция String Адреса контакта для обмена мгновенными сообщениями.
initials String Инициалы контакта.
jobTitle String Должность контакта.
lastModifiedDateTime DateTimeOffset Время изменения контакта. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
manager String Имя руководителя контакта.
middleName String Отчество контакта.
mobilePhone String Номер мобильного телефона контакта.
nickName String Псевдоним контакта.
officeLocation String Расположение офиса контакта.
otherAddress PhysicalAddress Другие адреса контакта.
parentFolderId String Идентификатор родительской папки контакта.
personalNotes String Заметки пользователя о контакте.
profession String Профессия контакта.
spouseName String Имя супруга или супруги контакта.
surname String Фамилия контакта.
title String Звание контакта.
yomiCompanyName String Название компании контакта, записанное так, как оно звучит по-японски.
yomiGivenName String Имя контакта, записанное так, как оно звучит по-японски.
yomiSurname String Фонетическая японская фамилия (фамилия) контакта.

Связи

Связь Тип Описание
extensions Коллекция extension Коллекция открытых расширений, определенных для контакта. Только для чтения. Допускается значение 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",
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}

Связанные материалы