大网数据广告活动
Microsoft Graph 接口

获取共享文件夹中的 Outlook 联系人

· 52CE 我爱测

在 Outlook 中,客户可以共享联系人文件夹并提供对文件夹的访问权限。 Outlook 还允许客户委托其他用户代表客户行事。

使用 Outlook,客户可以与其他人共享文件夹,并授予对各个联系人文件夹的读取、创建、修改或删除访问权限。 Outlook 还允许客户委托其他用户代表客户采取行动,并访问特定文件夹或客户的整个邮箱;这也称为 Outlook 中的 委派 。

Microsoft Graph 以编程方式支持在其他用户共享的联系人文件夹中获取联系人,以及获取共享文件夹本身。 此支持还适用于已委托的邮箱中的文件夹。

例如,Garth 已与 John 共享自定义联系人文件夹并向 John 授予读取权限。 如果 John 已登录到你的应用,并 (Contacts.Read.Shared 或 Contacts.ReadWrite.Shared) 提供了委派权限,则你的应用能够访问 Garth 的自定义联系人文件夹和该文件夹中的联系人。 有关详细信息,请参阅以下部分。

Note: Contacts.Read.Shared 或 Contacts.ReadWrite.Shared () 共享权限允许你在共享或委派的文件夹中读取或写入联系人。 它们不支持订阅此类文件夹中的项的更改通知。 若要对租户中共享、委托或任何其他用户的联系人文件夹中的联系人设置更改通知订阅,请使用应用程序权限 Contacts.Read。

获取共享文件夹中的联系人

可在 Garth 已与 John 共享的自定义联系人文件夹中获取特定联系人:

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}/contacts/{id}

成功完成后,你将收到“HTTP 200 正常”消息和由来自 Garth 共享联系人文件夹的 {id} 标识的联系人实例。

获取共享文件夹中的所有联系人

获取 Garth 共享联系人文件夹中的所有联系人:

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}/contacts

成功完成后,你将收到“HTTP 200 正常”消息和 Garth 共享联系人文件夹中的联系人实例的集合。

获取共享文件夹

获取 Garth 已与 John 共享的联系人文件夹。

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}

成功完成后,你将收到“HTTP 200 正常”消息和表示 Garth 共享联系人文件夹的 contactFolder 实例。

如果 Garth 已向 John 委托其整个邮箱,则将适用相同的 GET 功能。

如果 Garth 未与 John 共享联系人文件夹,也未将他的邮箱委派给 John,那么在这些 GET 操作中指定 Garth 的用户 ID 或用户主体名称将返回错误。

后续步骤

详细了解以下信息:

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 angelgolfer-ms)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。