通过

任务资源类型 (已弃用)

  • 项目

命名空间：microsoft.graph

重要

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

警告

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

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

此资源支持以下各项：

继承自 baseTask。

方法

方法 返回类型 说明
List tasks 任务集合 获取 任务 对象及其属性的列表。
获取任务 task 读取 任务 对象的属性和关系。
更新任务 task 更新 任务 对象的属性。
删除任务 无 删除 任务 对象。
移动 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 和 categories。 继承自 baseTask。
recurrence patternedRecurrence 任务的定期模式。 继承自 baseTask。
startDateTime dateTimeTimeZone 要在指定时区内开始执行任务的日期。 继承自 baseTask。
status taskStatus_v2 指示任务的状态或进度。 可能的值为： notStarted、 inProgress、 completed、unknownFutureValue。 继承自 baseTask。

关系

关系 类型 说明
checklistItems checklistItem 集合 链接到任务的清单项的集合。 继承自 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)"
}