orgContact 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

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

继承自 directoryObject。

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

Methods

方法	返回类型	说明
组织联系人
列出组织联系人	orgContact 集合	列出组织联系人的属性。
获取组织联系人	orgContact	读取 orgContact 对象的属性和关系。
组织层次结构
获取经理	directoryObject	获取联系人的经理。
Get transitiveReports	整数	从 transitiveReports 导航属性获取组织联系人的可传递报表计数。
List directReports	directoryObject collection	列出联系人的直接报告。
List memberOf	directoryObject 集合	获取 memberOf 对象集合。
checkMemberGroups	String collection	检查组成员身份。
getMemberGroups	String collection	返回指定联系人所属的所有组。
checkMemberObjects	String 集合	检查组、管理单元和目录角色中的成员身份。
getMemberObjects	String collection	获取联系人所属的组、管理单位和目录角色的列表。

属性

重要

仅当使用设置为 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	字符串	此组织联系人的名字。 支持 $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）。
mail	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;如果 此对象最初是从本地目录同步，但不再同步，现在已在Exchange中掌握，则为 false;如果从未从本地目录同步此对象，则为 null (默认) 。 支持 $filter（eq、ne、not、in 和 null 值上的 eq）。
phones	phone collection	此组织联系人的电话列表。 电话类型可以是移动、商业和 BusinessFax。 集合中只能存在每种类型之一。 支持 $filter（eq、ne、not、in）。
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 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"],
  "surname": "string"
}