Тип ресурса orgContact

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

Важно!

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

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

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

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

Методы

Метод	Возвращаемый тип	Описание
Контакты организации
Перечисление контактов организации	коллекция orgContact	Список свойств контактов организации.
Получение контакта в организации	orgContact	Чтение свойств и связей объекта orgContact.
Иерархия организации
Получение имени руководителя	directoryObject	Получите руководителя контакта.
Получение transitiveReports	Целое число	Получение количества транзитивных отчетов для контакта организации из свойства навигации transitiveReports.
Список directReports	Коллекция directoryObject	Вывод списка прямых отчетов контакта.
Список memberOf	Коллекция directoryObject	Получение коллекции объектов memberOf.
checkMemberGroups	Коллекция строк	Проверьте членство в группах.
getMemberGroups	Коллекция строк	Возвращает все группы, в которые входит указанный контакт.
checkMemberObjects	Коллекция String	Проверьте членство в группах, административных единицах и ролях каталогов.
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).
onPremisesLastSyncDateTime	DateTimeOffset	Дата и время последней синхронизации этого организационного контакта из локальной службы AD. Тип Timestamp представляет сведения о времени и дате с использованием формата 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. В коллекции может присутствовать только один из типов. Поддерживает $filter (eq, ne, not, in).
proxyAddresses	Коллекция строк	Например: "SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com". Для выражений фильтра в случае многозначных свойств требуется оператор any. Поддерживает $filter (eq, not, ge, le, startsWith, /$count eq 0, /$count ne 0).
serviceProvisioningErrors	serviceProvisioningError collection	Ошибки, опубликованные федеративной службой, описывающие не временную ошибку службы в отношении свойств или ссылки из объекта orgContact . Поддерживает $filter (eq, not, для isResolved и serviceInstance).
surname	String	Фамилия этого контактного лица в организации. Поддерживает $filter (eq, , ne, genot, le, instartsWithи eq для значенийnull).

Связи

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

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