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

Тип ресурса orgContact

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

Важно!

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

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

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

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

Методы

Метод Возвращаемый тип Описание
Контакты организации
List коллекция orgContact Список свойств контактов организации.
Получение orgContact Чтение свойств и связей объекта orgContact.
Получение дельты коллекция orgContact Получение вновь созданных, обновленных или удаленных контактов организации без необходимости полного считывания всей коллекции.
Получение разностного для объекта каталога коллекция direcyoryObject Получение вновь созданных, обновленных или удаленных контактов организации с помощью коллекции объектов каталога без необходимости полного считывания всей коллекции.
Список свойств member of Коллекция строк Получите список групп и административных единиц, членом которого является контакт. Это транзитивная проверка.
Перечисление транзитивного элемента Коллекция directoryObject Список групп, в которые входит контакт организации, включая группы, в которые вложен контакт организации.
Проверка членства в группах Коллекция строк Проверьте членство контакта в организации в списке групп. Это транзитивная проверка.
Получение групп пользователя Коллекция строк Возвращает все группы, в которые входит контакт организации. Это транзитивная проверка.
Проверка объектов-членов Коллекция строк Проверьте членство контакта в организации в списке групп, роли каталога или объектов административных единиц.
Вывод объектов членства Коллекция строк Возвращает все группы, административные единицы и роли каталога, в которые входит контакт организации. Это транзитивная проверка.
Повторная подготовка службы Нет Повторите попытку подготовки службы orgContact.
Получение транзитивных отчетов Integer Получение количества транзитивных отчетов для контакта организации из свойства навигации transitiveReports.
Поведение локальной синхронизации (источник центра)
Получение onPremisesSyncBehavior Проверьте, является ли источник центра связи (SOA) облаком или локальная служба Active Directory.
Обновление onPremisesSyncBehavior Обновите источник центра связи (SOA) в облаке или локальная служба Active Directory.
Иерархия организации
Получение имени руководителя 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).
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.
onPremisesSyncBehavior onPremisesSyncBehavior Указывает состояние синхронизации для объекта orgContact между облаком и локальная служба Active Directory. Поддерживает $filter только расширенные возможности запросов, например $filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true.
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"
}
  • Last updated on