baseTask 资源类型 (已弃用)

命名空间:microsoft.graph

重要

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

警告

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

一种抽象类型,表示可跟踪和完成的任务,例如工作或个人项目。

这是 任务 资源继承的基类型。

方法

方法 返回类型 说明
列出 baseTasks baseTask 集合 获取 baseTask 对象及其属性的列表。
创建 baseTask baseTask 创建新的 baseTask 对象。
获取 baseTask baseTask 读取 baseTask 对象的属性和关系。
Update baseTask baseTask 更新 baseTask 对象的属性。
删除 baseTask 删除 baseTask 对象。
移动 baseTask 将邮件移动到其他列表。
delta baseTask 集合 获取一组已在指定列表中添加、删除或更新的 baseTask 对象。
列出 checklistItems checklistItem 集合 checklistItems 导航属性获取 checklistItem 资源。
创建 checklistItem checklistItem 创建新的 checklistItem 对象。
列出 linkedResources linkedResource_v2 集合 从 linkedResources 导航属性获取 linkedResource_v2 资源。
创建linkedResource_v2 linkedResource_v2 创建新的 linkedResource_v2 对象。

属性

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

关系

关系 类型 说明
checklistItems checklistItem 集合 链接到更复杂的父任务的较小子任务的集合。
extensions 扩展集合 为任务 定义的开放扩展的集合。
linkedResources linkedResource_v2 集合 链接到任务的资源集合。
parentList baseTaskList 包含任务的列表。

JSON 表示形式

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

{
  "@odata.type": "#microsoft.graph.baseTask",
  "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)"
}