orgContact 资源类型
命名空间:microsoft.graph
表示组织联系人。 组织联系人由组织的管理员管理,不同于 个人联系人。 此外,组织联系人要么从本地目录同步,要么从Exchange Online同步,并且在 Microsoft Graph中是只读的。
继承自 directoryObject。
该资源支持通过提供 delta 函数使用增量查询跟踪增量添加、删除和更新。 此资源是允许传入其他属性的开放类型。
Methods
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 组织联系人 | ||
| 列出组织联系人 | orgContact | 列出组织联系人的属性。 |
| 获取组织联系人 | orgContact | 读取组织联系人的属性和关系。 |
| 组织层次结构 | ||
| 获取经理 | directoryObject | 获取组织联系人的经理。 |
| List directReports | directoryObject collection | 列出组织联系人的直接报告。 |
| List memberOf | directoryObject collection | 列出组织联系人所属的组。 |
| 列出 transitiveMemberOf | directoryObject 集合 | 列出组织联系人所属的组,包括组织联系人嵌套在其中的组。 |
| checkMemberGroups | String collection | 检查组成员身份。 |
| getMemberGroups | String collection | 返回指定组织联系人所属的所有组。 |
| getMemberObjects | String collection | 返回组织联系人所属的 directoryObjects 的列表。 |
属性
重要
仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时,才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息,请参阅 Azure AD 目录对象的高级查询功能。
| 属性 | 类型 | 说明 |
|---|---|---|
| 地址 | physicalOfficeAddress 集合 | 此组织联系人的邮政地址。 目前,联系人只能有一个物理地址。 |
| CompanyName | String | 此组织联系人所属的公司名称。 支持 $filter(eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)。 |
| 部门 | String | 联系人所在的部门的名称。 支持 $filter(eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)。 |
| displayName | 字符串 | 此组织联系人的显示名称。 支持 $filter (eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)、$search 和 $orderBy。 |
| givenName | String | 此组织联系人的名字。 支持 $filter(eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)。 |
| id | 字符串 | 此组织联系人的唯一标识符。 支持 $filter(eq、ne、not、in)。 |
| jobTitle | String | 此组织联系人的职务。 支持 $filter(eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)。 |
| String | 联系人的 SMTP 地址,例如“jeff@contoso.onmicrosoft.com”。 支持 $filter(eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)。 |
|
| mailNickname | String | 电子邮件别名 (电子邮件地址的一部分,预先挂起此组织联系人的 @符号) 。 支持 $filter(eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)。 |
| 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)。 |
| onPremisesSyncEnabled | Boolean | true如果此对象是从本地目录同步的,false如果此对象最初是从本地目录同步的,但不再同步,现在已在Exchange中掌握;null如果此对象从未从本地目录同步, (默认) 。 支持 $filter(eq、ne、not、in 和 null 值上的 eq)。 |
| phones | phone collection | 此组织联系人的电话列表。 电话类型可以是移动、商业和 BusinessFax。 集合中只能存在每种类型之一。 |
| proxyAddresses | String collection | 例如:“SMTP:bob@contoso.com”、“smtp:bob@sales.contoso.com”。 需要多值属性筛选器表达式的 any 运算符。 支持$filter (eq、not、ge和le``startsWith计数空集合) 。 |
| surname | String | 此组织联系人的姓氏。 支持 $filter(eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| directReports | directoryObject collection | 联系人的直接报告。 (其管理器属性设置为此联系人的用户和联系人。) 只读。 可为 NULL。 支持 $expand。 |
| manager | directoryObject | 此联系人的经理的用户或联系人。 只读。 支持 $expand。 |
| memberOf | directoryObject 集合 | 此联系人所属的组。 只读。 可为 NULL。 支持 $expand。 |
| transitiveMemberOf | directoryObject collection | 此联系人所属的组,包括联系人嵌套在其中的组。 只读。 可为 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"],
"surname": "string"
}
反馈
提交和查看相关反馈