Тип ресурса orgContact

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

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

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

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

Методы

Метод	Возвращаемый тип	Описание
Контакты организации
List	orgContact	Список свойств контактов организации.
Получение	orgContact	Чтение свойств и связей контакта в организации.
Получение дельты	коллекция orgContact	Получение вновь созданных, обновленных или удаленных контактов организации без необходимости полного считывания всей коллекции.
Получение разностного для объекта каталога	коллекция direcyoryObject	Получение вновь созданных, обновленных или удаленных контактов организации с помощью коллекции объектов каталога без необходимости полного считывания всей коллекции.
Список свойств member of	Коллекция строк	Получите список групп и административных единиц, членом которого является контакт. Это транзитивная проверка.
Перечисление транзитивных членов	Коллекция directoryObject	Список групп, в которые входит контакт организации, включая группы, в которые вложен контакт организации.
Проверка членства в группах	Коллекция строк	Проверьте членство контакта в организации в списке групп. Это транзитивная проверка.
Получение групп пользователя	Коллекция строк	Возвращает все группы, в которые входит контакт организации. Это транзитивная проверка.
Проверка объектов-членов	Коллекция строк	Проверьте членство контакта в организации в списке групп, роли каталога или объектов административных единиц.
Вывод объектов членства	Коллекция строк	Возвращает все группы, административные единицы и роли каталога, в которые входит контакт организации. Это транзитивная проверка.
Повторная подготовка службы	Нет	Повторите попытку подготовки службы orgContact.
Иерархия организации
Получение имени руководителя	directoryObject	Получение руководителя контактного лица организации.
Список подчиненных	Коллекция directoryObject	Перечисление прямых отчетов контактного лица организации.

Свойства

Важно!

Определенное использование $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	Отображаемое имя для этого контакта в организации. Максимальная длина: 256 символов. Поддерживает $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"
}