已弃用的任务资源类型 ()

项目
06/01/2022

命名空间：microsoft.graph

重要

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

注意

基于 baseTask 构建的即用 API 集自 2022 年 5 月 31 日开始弃用，并将于 2022 年 8 月 31 日停止返回数据。请使用基于 todoTask 构建的 API 集。

表示可跟踪和完成的任务（如工作项或个人项）。任务始终包含在基本任务列表中。

此资源支持以下各项：

在打开的扩展中将数据添加为自定义属性。
订阅更改通知。
使用增量查询跟踪增量添加、删除和更新。

继承自 baseTask。

方法

方法	返回类型	说明
列出任务	任务集合	获取任务对象及其属性的列表。
获取任务	任务	读取任务对象的属性和关系。
更新任务	任务	更新任务对象的属性。
删除任务	无	删除任务对象。
移动	baseTask	将消息移动到其他列表。
列出 checklistItems	checklistItem 集合	从 checklistItems 导航属性获取 checklistItem 资源。
创建 checklistItem	checklistItem	创建新的 checklistItem 对象。
列出 linkedResources	linkedResource_v2 集合	从 linkedResources 导航属性获取linkedResource_v2资源。
创建 linkedResource	linkedResource_v2	创建新的linkedResource_v2对象。

属性

属性	类型	说明
textbody	itemBody	通常包含有关任务的信息的文本格式的任务正文。继承自 baseTask。
bodyLastModifiedDateTime	DateTimeOffset	上次修改任务的日期和时间。默认情况下，它采用 UTC 格式。你可以在请求标头中提供自定义时区。属性值使用 ISO 8601 格式，并始终处于 UTC 时间。例如，2020 年 1 月 1 日午夜 UTC 如下所示：“2020-01-01T00：00：00Z”。继承自 baseTask。
completedDateTime	DateTimeOffset	任务完成的日期。继承自 baseTask。
createdDateTime	DateTimeOffset	任务的创建日期和时间。默认情况下，它采用 UTC 格式。你可以在请求标头中提供自定义时区。属性值使用 ISO 8601 格式。例如，2020 年 1 月 1 日午夜 UTC 如下所示：“2020-01-01T00：00：00Z”。继承自 baseTask。
displayName	String	任务的名称。继承自 baseTask。
dueDateTime	dateTimeTimeZone	要在指定时区内完成任务的日期。继承自 baseTask。
id	String	任务的唯一标识符。默认情况下，如果任务从一个列表移动到另一个列表，则此值不会更改。继承自 baseTask。
importance	importance	任务的重要性。可取值为：`low`、`normal`、`high`。继承自 baseTask。可能的值包括 `low`、`normal`、`high`。
lastModifiedDateTime	DateTimeOffset	上次修改任务的日期和时间。默认情况下，它采用 UTC 格式。你可以在请求标头中提供自定义时区。属性值使用 ISO 8601 格式，并始终处于 UTC 时间。例如，2020 年 1 月 1 日午夜 UTC 如下所示：“2020-01-01T00：00：00Z”。继承自 baseTask。
观点	taskViewpoint	用户的个人属性，例如 reminderDateTime 和类别。继承自 baseTask。
recurrence	patternedRecurrence	任务的定期模式。继承自 baseTask。
startDateTime	dateTimeTimeZone	要在指定时区内开始执行任务的日期。继承自 baseTask。
status	taskStatus_v2	指示任务的状态或进度。可能的值为： `notStarted`， `inProgress`， `completed`，`unknownFutureValue`。继承自 baseTask。

关系

关系	类型	说明
checklistItems	checklistItem 集合	链接到任务的 checklistItems 的集合。继承自 baseTask
extensions	扩展集合	为任务定义的开放扩展的集合。继承自 baseTask
linkedResources	linkedResource_v2 集合	链接到任务的资源集合。继承自 baseTask
parentList	baseTaskList	包含任务的列表。继承自 baseTask

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.task",
  "textBody": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)",
  "completedDateTime": "String (timestamp)",
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "importance": "String",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "displayName": "String",
  "status": "String",
  "viewpoint": {
    "@odata.type": "microsoft.graph.taskViewpoint"
  },
  "id": "String (identifier)"
}

已弃用的任务资源类型 ()

方法

属性

关系

JSON 表示形式

反馈