todoTaskList 资源类型

命名空间：microsoft.graph

重要

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

Microsoft 中的一个列表，其中包含一个或多个 todoTask 资源。

在中，有一些内置的任务列表（如已 标记的电子邮件 和 任务 ），无法重命名或删除。 不过，您可以创建其他任务列表。

此资源支持

• 将数据作为开放扩展添加到自定义属性
• 使用 delta 查询 跟踪增量添加、删除和更新。

方法

方法	返回类型	说明
列出列表	todoTaskList 集合	获取用户邮箱中的所有 todoTaskList 。
创建 todoTaskList	todoTaskList	在用户的邮箱中创建 todoTaskList 。
获取任务列表	todoTaskList	读取指定 todoTaskList的属性和关系。
更新任务列表	todoTaskList	更新指定 todoTaskList的可写属性。
删除任务列表	无	删除指定的 todoTaskList 。
List tasks	todoTask 集合	获取指定列表中的所有 todoTask 资源。
创建任务	todoTask	在指定的任务列表中创建 todoTask 。

属性

属性	类型	说明
displayName	字符串	任务列表的名称。
id	字符串	任务列表的标识符，在用户的邮箱中是唯一的。 只读。 继承自 entity
isOwner	Boolean	如果用户是给定任务列表的所有者，则为 True。
isShared	Boolean	如果任务列表与其他用户共享，则为 True
wellknownListName	wellknownListName	如果给定的列表是已知列表，则指示列表名称的属性。 可取值为：none、defaultList、flaggedEmails、unknownFutureValue。

wellknownListName 值

成员	说明
无	用户创建的列表。
defaultList	内置 任务 列表。
flaggedEmails	内置的已 标记电子邮件 列表。 此列表中存在已标记的电子邮件中的任务。
向 unknownfuturevalue	Evolvable 枚举 sentinel 值。 请勿使用。

关系

关系	类型	说明
extensions	扩展集合	为任务列表定义的开放扩展的集合。 可为 Null。
任务	todoTask 集合	此任务列表中的任务。 只读。 可为 Null。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.todoTaskList",
  "id": "String (identifier)",
  "displayName": "String",
  "isOwner": "Boolean",
  "isShared": "Boolean",
  "wellknownListName": "String"
}