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


Тип ресурса contact

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

Методы

Метод Возвращаемый тип Описание
Получение contact Считывание свойств и отношений объекта contact.
Создание contact Добавление контакта в корневую папку с контактами или конечную точку контактов другой папки с контактами.
Обновление contact Обновление объекта contact.
Удаление Нет Удаление объекта contact.
Удалить без возможности восстановления Нет Окончательно удалите контакт и поместите его в папку Purges в папке "Элементы с возможностью восстановления" в почтовом ящике пользователя.
Получение дельты контакта Коллекция 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.
categories Коллекция String Категории, связанные с контактом. Каждая категория соответствует свойству displayName объекта outlookCategory, определенного для пользователя.
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 коллекция typedEmailAddress Электронные адреса контакта.
fileAs String Имя, под которым хранится контакт.
flag followupFlag Значение флага, указывающее состояние, дату начала, дату выполнения или дату завершения контакта.
gender String Пол контакта.
generation String Суффикс контакта.
givenName; 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 Отчество контакта.
nickName String Псевдоним контакта.
officeLocation String Расположение офиса контакта.
parentFolderId String Идентификатор родительской папки контакта.
personalNotes String Заметки пользователя о контакте.
phones Коллекция phone Номера телефонов, связанные с контактом, например домашний телефон, мобильный телефон и рабочий телефон.
postalAddresses коллекция physicalAddress Адреса, связанные с контактом, например домашний адрес и рабочий адрес.
profession String Профессия контакта.
spouseName String Имя супруга или супруги контакта.
surname String Фамилия контакта.
title String Звание контакта.
websites Коллекция website Веб-сайты, связанные с контактом.
weddingAnniversary Date Годовщина свадьбы контакта.
yomiCompanyName String Название компании контакта, записанное так, как оно звучит по-японски.
yomiGivenName String Имя контакта, записанное так, как оно звучит по-японски.
yomiSurname String Фонетическая японская фамилия (фамилия) контакта.

Связи

Связь Тип Описание
extensions Коллекция extension Коллекция открытых расширений, определенных для контакта. Допускается значение null.
multiValueExtendedProperties Коллекция multiValueLegacyExtendedProperty Коллекция расширенных свойств с несколькими значениями, определенных для контакта. Только для чтения. Допускается значение null.
Фотография photo Необязательное фото контакта. Можно получить или задать фото для контакта.
singleValueExtendedProperties Коллекция singleValueLegacyExtendedProperty Коллекция расширенных свойств с одним значением, определенных для контакта. Только для чтения. Допускается значение null.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "assistantName": "string",
  "birthday": "String (timestamp)",
  "categories": ["string"],
  "changeKey": "string",
  "children": ["string"],
  "companyName": "string",
  "createdDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.typedEmailAddress"}],
  "fileAs": "string",
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "gender": "string",
  "generation": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "initials": "string",
  "jobTitle": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "manager": "string",
  "middleName": "string",
  "nickName": "string",
  "officeLocation": "string",
  "parentFolderId": "string",
  "personalNotes": "string",
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.physicalAddress"}],
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "websites": [{"@odata.type": "microsoft.graph.website"}],
  "weddingAnniversary": "date",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}