todoTask 资源类型

命名空间:microsoft.graph

重要

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

todoTask 表示可以跟踪和完成的任务,例如工作或个人项目。

todoTask 始终包含在 todoTaskList 中。 它包括与 linkedResource 对象集合的关系,用于跟踪任务的一个或多个源。

此资源支持以下各项:

方法

方法 返回类型 说明
列出任务 todoTask 集合 获取指定列表中的所有 todoTask 资源。
创建任务 todoTask 在指定的任务列表中创建 todoTask
获取任务 todoTask 读取 todoTask 对象的属性和关系。
更新任务 todoTask 更新 todoTask 对象的属性。
删除任务 None 删除 todoTask 对象。
列出 checklistItems checklistItem 集合 checklistItems 导航属性获取 checklistItem 资源。
创建 checklistItem checklistItem 创建新的 checklistItem 对象。
列出 linkedResources linkedResource 集合 从 linkedResources 导航属性获取 linkedResources。
创建 linkedResources linkedResource 创建新的 linkedResources 对象。

属性

属性 类型 说明
body itemBody 通常包含有关任务的信息的任务正文。
bodyLastModifiedDateTime DateTimeOffset 上次修改任务正文的日期和时间。 默认情况下,它采用 UTC 格式。 你可以在请求标头中提供自定义时区。 属性值使用 ISO 8601 格式,并始终处于 UTC 时间。 例如,2020 年 1 月 1 日午夜 UTC 如下所示:“2020-01-01T00:00:00Z”。
类别 String 集合 与任务关联的类别。 每个类别对应于用户定义的 outlookCategorydisplayName 属性。
completedDateTime dateTimeTimeZone 任务完成的指定时区中的日期和时间。
createdDateTime DateTimeOffset 任务的创建日期和时间。 默认情况下,它采用 UTC 格式。 你可以在请求标头中提供自定义时区。 属性值使用 ISO 8601 格式。 例如,2020 年 1 月 1 日午夜 UTC 如下所示:“2020-01-01T00:00:00Z”。
dueDateTime dateTimeTimeZone 任务要完成的指定时区中的日期和时间。
hasAttachments Boolean 指示任务是否具有附件。
id String 任务的唯一标识符。 默认情况下,当项目从一个列表移动到另一个列表时,此值会更改。
importance importance 任务的重要性。 可取值为:lownormalhigh
isReminderOn Boolean 如果设置警报以提醒用户有任务,则设置为 true。
lastModifiedDateTime DateTimeOffset 上次修改任务的日期和时间。 默认情况下,它采用 UTC 格式。 你可以在请求标头中提供自定义时区。 属性值使用 ISO 8601 格式,并始终处于 UTC 时间。 例如,2020 年 1 月 1 日午夜 UTC 如下所示:“2020-01-01T00:00:00Z”。
recurrence patternedRecurrence 任务的定期模式。
reminderDateTime dateTimeTimeZone 指定时区中要发生的任务的提醒警报的日期和时间。
startDateTime dateTimeTimeZone 计划任务开始的指定时区中的日期和时间。
状态 任务状态 指示任务的状态或进度。 可取值为:notStartedinProgresscompletedwaitingOnOthersdeferred
title String 任务的简要说明。

关系

关系 类型 说明
attachments taskFileAttachment 集合 任务的文件附件的集合。
checklistItems checklistItem 集合 链接到更复杂的父任务的较小子任务的集合。
extensions 扩展集合 为任务定义的开放扩展的集合。 可为 NULL。
linkedResources linkedResource 集合 链接到任务的资源集合。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.todoTask",
  "id": "String (identifier)",
  "body": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "categories": ["string"],
  "completedDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "importance": "String",
  "isReminderOn": "Boolean",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "reminderDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}