Тип ресурса 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. |
| Иерархия организации | ||
| Получение имени руководителя | 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 | Отображаемое имя для этого контакта в организации. Поддерживает $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 | Псевдоним электронной почты (часть адреса электронной почты, предварительно ожидающая символ @) для этого контакта организации. Поддерживает $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"
}