Тип ресурса orgContact

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

Представляет контакт организации. Организационные контакты управляются администраторами организации и отличаются от личных контактов. Кроме того, контакты организации синхронизируются из локальных каталогов или из Exchange Online и доступны только для чтения в Microsoft Graph.

Наследуется от directoryObject.

Этот ресурс поддерживает отслеживание добавлений, удалений и обновлений с помощью разностного запроса с функцией delta. Этот ресурс относится к открытому типу, который позволяет передавать другие свойства.

Методы

Метод	Возвращаемый тип	Описание
Контакты организации
Перечисление контактов организации	orgContact	Список свойств контактов организации.
Получение контакта в организации	orgContact	Чтение свойств и связей контакта в организации.
Иерархия организации
Получение имени руководителя	directoryObject	Получение руководителя контактного лица организации.
Список directReports	Коллекция directoryObject	Перечисление прямых отчетов контактного лица организации.
Список memberOf	Коллекция directoryObject	Перечисление групп, в которые входит контакт организации.
Перечисление transitiveMemberOf	Коллекция directoryObject	Список групп, в которые входит контакт организации, включая группы, в которые вложен контакт организации.
checkMemberGroups	Коллекция строк	Проверьте членство в группах.
getMemberGroups	Коллекция строк	Возвращает все группы, в которые входит указанный контакт организации.
getMemberObjects	Коллекция строк	Возвращает список объектов каталога, в которые входит контакт организации.

Свойства

Важно!

Определенное использование $filter и параметра запроса $search поддерживается только при применении заголовка ConsistencyLevel с присвоенным значением eventual и $count. Дополнительные сведения см. в разделе Расширенные возможности запросов к объектам каталогов.

Свойство	Тип	Описание
Адреса	коллекция physicalOfficeAddress	Почтовые адреса для этого контакта в организации. Сейчас контакт может иметь только один физический адрес.
CompanyName	String	Название компании, к которой принадлежит этот организационный контакт. Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для значенийnull).
department	String	Имя отдела, в котором работает контакт. Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для значенийnull).
displayName	String	Отображаемое имя для этого контакта в организации. Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для null значений), $search, и $orderby.
givenName;	String	Имя этого контактного лица в организации. Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для значенийnull).
id	String	Уникальный идентификатор для этого контакта в организации. Поддерживает $filter (eq, ne, not, in).
jobTitle;	String	Название должности для этого контактного лица в организации. Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для значенийnull).
почта;	String	SMTP-адрес контакта, например "jeff@contoso.com". Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для значенийnull).
mailNickname	String	Email псевдоним (часть адреса электронной почты до символа @) для этого контакта в организации. Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для значенийnull).
serviceProvisioningErrors	serviceProvisioningError collection	Ошибки, опубликованные федеративной службой, описывающие невременную, связанную со службой ошибку в отношении свойств или ссылки из объекта контакта организации . Поддерживает $filter (eq, not, для isResolved и serviceInstance).
onPremisesLastSyncDateTime	DateTimeOffset	Дата и время последней синхронизации этого организационного контакта из локальной службы AD. Эта информация о дате и времени использует формат ISO 8601 и всегда указана в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Поддерживает $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors	Коллекция onPremisesProvisioningError	Список ошибок при подготовке синхронизации для этого контакта в организации. Поддерживает $filter (eq, not для категорий и свойствCausingError), /$count eq 0, . /$count ne 0
onPremisesSyncEnabled	Логический	true Значение , если этот объект синхронизирован из локального каталога; false Значение , если этот объект был первоначально синхронизирован из локального каталога, но больше не синхронизируется и теперь используется в Exchange; null Значение , если этот объект никогда не синхронизировался из локального каталога (по умолчанию). Поддерживает $filter (eq, , notne, inи eq для значенийnull).
phones	Коллекция phone	Список телефонов для этого контакта в организации. Типы телефонов могут быть мобильными, бизнес и businessFax. В коллекции может присутствовать только один из типов.
proxyAddresses	Коллекция строк	Например: "SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com". Для выражений фильтра в случае многозначных свойств требуется оператор any. Поддерживает $filter (eq, not, ge, le, startsWith, /$count eq 0, /$count ne 0).
surname	String	Фамилия этого контактного лица в организации. Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для значенийnull).

Связи

Связь	Тип	Описание
directReports	Коллекция directoryObject	Прямые отчеты контакта. (Пользователи и контакты, для которых свойству руководителя присвоено значение этого контакта.) Только для чтения. Допускается значение null. Поддерживает $expand.
manager	directoryObject	Пользователь или контакт, который является руководителем этого контакта. Только для чтения. Поддерживает $expand и $filter (eq) по идентификатору.
memberOf	Коллекция directoryObject	Группы, в которые входит этот контакт. Только для чтения. Допускается значение null. Поддерживает $expand.
transitiveMemberOf	Коллекция directoryObject	Группы, членом которых является этот контакт, включая группы, в которые вложен контакт. Только для чтения. Допускается значение null.

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

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

{
  "addresses": [{"@odata.type": "microsoft.graph.physicalOfficeAddress"}],
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "jobTitle": "string",
  "mail": "string",
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "string (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSyncEnabled": true,
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "proxyAddresses": ["string"],
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "surname": "string"
}