orgContact 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示组织联系人。 组织联系人由组织的管理员管理，与 个人联系人不同。 此外，组织联系人要么从本地目录同步，要么从 Exchange Online 同步，在 Microsoft Graph 中是只读的。
继承自 directoryObject。
该资源支持通过提供 delta 函数使用增量查询跟踪增量添加、删除和更新。 此资源是允许传入其他属性的开放类型。
Methods
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 组织联系人 | ||
| List | orgContact 集合 | 列出组织联系人的属性。 |
| 获取 | orgContact | 读取 orgContact 对象的属性和关系。 |
| 获取增量 | orgContact 集合 | 获取新创建、更新或删除的组织联系人，而无需执行整个集合的完整读取。 |
| 获取目录对象的增量 | direcyoryObject 集合 | 通过目录对象集合获取新创建、更新或删除的组织联系人，而无需执行整个集合的完整读取。 |
| 列出隶属于 | 字符串集合 | 检索联系人所属的组和管理单元的列表。 检查是可传递的。 |
| 列出 的可传递成员 | directoryObject collection | 列出组织联系人所属的组，包括组织联系人嵌套的组。 |
| 检查成员组 | 字符串集合 | 检查组列表中的组织联系人的成员身份。 检查是可传递的。 |
| 获取成员组 | 字符串集合 | 返回组织联系人所属的所有组。 检查是可传递的。 |
| 检查成员对象 | 字符串集合 | 检查组、目录角色或管理单元对象列表中的组织联系人的成员身份。 |
| 获取成员对象 | 字符串集合 | 返回组织联系人所属的所有组、管理单元和目录角色。 检查是可传递的。 |
| 重试服务预配 | None | 重试 orgContact 服务预配。 |
| 获取可传递报表 | 整数 | 从 transitiveReports 导航属性获取组织联系人的可传递报表计数。 |
| 组织层次结构 | ||
| 获取管理器 | directoryObject | 获取联系人的经理。 |
| 列出直接下属 | directoryObject collection | 列出联系人的直接下属。 |
属性
重要
仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时，才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息，请参阅 目录对象的高级查询功能。
| 属性 | 类型 | 说明 |
|---|---|---|
| 地址 | physicalOfficeAddress 集合 | 此组织联系人的邮政地址。 目前，一个联系人只能有一个物理地址。 |
| CompanyName | String | 此组织联系人所属的公司名称。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull |
| department | String | 联系人所在的部门的名称。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull |
| displayName | String | 此组织联系人的显示名称。
not
eq
in
startsWith
le
ne
ge) 、 和 nulleq 的值支持 $filter (、、$search、 和 。$orderby |
| givenName | String | 此组织联系人的名字。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull |
| id | String | 此组织联系人的唯一标识符。 支持 $filter （eq、 ne、 not、 in）。 |
| jobTitle | String | 此组织联系人的职务。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull |
| String | 联系人的 SMTP 地址，例如“jeff@contoso.com”。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull |
|
| mailNickname | String | 电子邮件别名 (电子邮件地址的一部分，此组织联系人的 @ 符号) 。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull |
| onPremisesLastSyncDateTime | DateTimeOffset | 上次从本地 AD 同步此组织联系人的日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 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 | Boolean | 如果此对象从本地目录同步，则为 true;如果此对象最初从本地目录同步，但不再同步，现在已在 Exchange 中主控，则为 false;如果从未从本地目录同步此对象，则为 null， (默认) 。 支持 $filter (eq、 ne、 not、 in和 eq 值 null) 。 |
| phones | phone collection | 此组织联系人的电话列表。 手机类型可以是移动、商务和商务Fax。 集合中只能存在每种类型中的一种。 支持 $filter （eq、 ne、 not、 in）。 |
| proxyAddresses | String collection | 例如：“SMTP： bob@contoso.com”， “smtp： bob@sales.contoso.com”。 需要多值属性筛选器表达式的 any 运算符。 支持 $filter （eq、 not、 ge、 le、 startsWith、 /$count eq 0、 /$count ne 0）。 |
| serviceProvisioningErrors | serviceProvisioningError 集合 | 联合服务发布的错误，描述有关 orgContact 对象 中的属性或链接的非暂时性特定于服务的错误。 对于 isResolved 和 serviceInstance) eqnot，支持 $filter (、、 。 |
| surname | String | 此组织联系人的姓氏。 支持$filter对值 (eq、ne、not、 inlestartsWithge和) eqnull |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| directReports | directoryObject collection | 联系人的直接下属。 (将经理属性设置为此 contact 的用户和联系人。) 只读。 可为 NULL。 支持 $expand。 |
| manager | directoryObject | 此联系人的经理的用户或联系人。 此为只读属性。 支持 $expand 并 $filter (eq 按 id) 。 |
| memberOf | directoryObject collection | 此联系人所属的组。 此为只读属性。 可为 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"
}