contactFolder 资源类型

命名空间：microsoft.graph

重要

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

包含联系人的文件夹。

该资源支持通过提供 delta 函数使用增量查询跟踪增量添加、删除和更新。

方法

方法	返回类型	说明
获取 contactFolder	contactFolder	通过使用联系人文件夹 ID 获取联系人文件夹。
更新	contactFolder	更新 contactFolder 对象。
删除	无	删除 contactFolder 对象。
列出 childFolder	ContactFolder 集合	获取指定联系人文件夹下的子文件夹的集合。
创建子 ContactFolder	contactFolder	创建一个新的 contactFolder 作为指定文件夹的子文件夹。
delta	联系人集合	获取用户邮箱中已添加、删除或移除的联系人文件夹集。
列出文件夹中的联系人	contact 集合	从已登录用户的默认联系人文件夹 (`.../me/contacts`) 获取联系人集合，或者从指定的联系人文件夹中获取联系人集合。
在文件夹中创建联系人	联系人	将联系人添加到根联系人文件夹或其他 `contacts` 联系人文件夹的终结点。
扩展属性
创建单值扩展属性	contactFolder	在新的或现有的 contactFolder 中创建一个或多个单值扩展属性。
获取包含单值扩展属性的 contactFolder	contactFolder	使用 `$expand` 或 `$filter`获取包含单值扩展属性的 contactFolders。
创建多值扩展属性	contactFolder	在新的或现有的 contactFolder 中创建一个或多个多值扩展属性。
获取包含多值扩展属性的 contactFolder	contactFolder	使用 `$expand`获取包含多值扩展属性的 contactFolder。

属性	类型	说明
displayName	String	文件夹的显示名称。
id	String	联系人文件夹的唯一标识符。只读。
parentFolderId	String	文件夹的父文件夹 ID。
wellKnownName	string	如果该文件夹是可识别的文件夹，则为文件夹的名称。目前 `contacts` 是唯一可识别的联系人文件夹。

关系	类型	说明
childFolders	ContactFolder 集合	文件夹中的子文件夹集合。导航属性。只读。可为 Null。
contacts	contact 集合	文件夹中的联系人。导航属性。只读。可为 Null。
multiValueExtendedProperties	multiValueLegacyExtendedProperty 集合	为 contactFolder 定义的多值扩展属性的集合。此为只读属性。可为 Null。
singleValueExtendedProperties	singleValueLegacyExtendedProperty collection	为 contactFolder 定义的单值扩展属性的集合。此为只读属性。可为 Null。

下面是资源的 JSON 表示形式。

{
  "displayName": "String",
  "id": "String (identifier)",
  "parentFolderId": "String",
  "wellKnownName": "String"
}