orgContact 资源类型

命名空间：microsoft.graph

表示组织联系人。 组织联系人由组织的管理员管理，与 个人联系人不同。 此外，组织联系人要么从本地目录同步，要么从Exchange Online同步，在 Microsoft Graph 中是只读的。

继承自 directoryObject。

该资源支持通过提供 delta 函数使用增量查询跟踪增量添加、删除和更新。 此资源是允许传入其他属性的开放类型。

Methods

方法	返回类型	说明
组织联系人
列出组织联系人	orgContact	列出组织联系人的属性。
获取组织联系人	orgContact	读取组织联系人的属性和关系。
组织层次结构
获取管理器	directoryObject	获取组织联系人的经理。
List directReports	directoryObject collection	列出组织联系人的直接下属。
List memberOf	directoryObject collection	列出组织联系人所属的组。
列出 transitiveMemberOf	directoryObject 集合	列出组织联系人所属的组，包括组织联系人嵌套的组。
checkMemberGroups	字符串集合	检查组成员身份。
getMemberGroups	String collection	返回指定组织联系人所属的所有组。
getMemberObjects	String collection	返回组织联系人所属的目录对象列表。

属性

重要

仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时，才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息，请参阅 目录对象的高级查询功能。

属性	类型	说明
地址	physicalOfficeAddress 集合	此组织联系人的邮政地址。 目前，一个联系人只能有一个物理地址。
CompanyName	String	此组织联系人所属的公司名称。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
department	String	联系人所在的部门的名称。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
displayName	String	此组织联系人的显示名称。 noteqinstartsWithlenege) 、 和 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
mail	String	联系人的 SMTP 地址，例如“jeff@contoso.com”。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
mailNickname	String	Email别名 (电子邮件地址的一部分，此组织联系人的 @ 符号) 之前挂起。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
serviceProvisioningErrors	serviceProvisioningError 集合	联合服务发布的错误，描述与组织联系人对象 中的属性或链接相关的非暂时性、特定于服务的错误。 对于 isResolved 和 serviceInstance) eqnot，支持 $filter (、、 。
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 如果从本地目录同步此对象，则为 ; false 如果此对象最初从本地目录同步，但不再同步，现在已在 Exchange 中主控，则为 ; null 如果从未从本地目录同步此对象，则 (默认) 。 支持 $filter (eq、 ne、 not、 in和 eq 值 null) 。
phones	phone collection	此组织联系人的电话列表。 手机类型可以是移动、商务和商务Fax。 集合中只能存在每种类型中的一种。
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）。
surname	String	此组织联系人的姓氏。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull

关系

关系	类型	说明
directReports	directoryObject collection	联系人的直接下属。 (将经理属性设置为此 contact 的用户和联系人。) 只读。 可为 NULL。 支持 $expand。
manager	directoryObject	此联系人的经理的用户或联系人。 此为只读属性。 支持 $expand 并 $filter (eq 按 id) 。
memberOf	directoryObject collection	此联系人所属的组。 此为只读属性。 可为 NULL。 支持 $expand。
transitiveMemberOf	directoryObject 集合	此联系人所属的组，包括嵌套联系人的组。 此为只读属性。 可为 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"],
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "surname": "string"
}