todoTask 资源类型

项目
07/15/2022

命名空间：microsoft.graph

todoTask 表示可跟踪和完成的任务（如工作项或个人项）。

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

此资源支持以下各项：

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

方法

方法	返回类型	说明
列出任务	todoTask 集合	获取指定列表中的所有 todoTask 资源。
创建任务	todoTask	在指定的任务列表中创建 todoTask
获取任务	todoTask	读取 todoTask 对象的属性和关系。
更新任务	todoTask	更新 todoTask 对象的属性。
删除任务	无	删除 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 集合	与任务关联的类别。每个类别对应于用户定义的 outlookCategory 的 displayName 属性。
completedDateTime	dateTimeTimeZone	在指定时区内完成任务的日期。
createdDateTime	DateTimeOffset	任务的创建日期和时间。默认情况下，它采用 UTC 格式。你可以在请求标头中提供自定义时区。属性值使用 ISO 8601 格式。例如，2020 年 1 月 1 日午夜 UTC 如下所示：“2020-01-01T00：00：00Z”。
dueDateTime	dateTimeTimeZone	要在指定时区内完成任务的日期。
id	String	任务的唯一标识符。默认情况下，当项从一个列表移动到另一个列表时，此值会更改。
importance	importance	任务的重要性。可取值为：`low`、`normal`、`high`。
isReminderOn	Boolean	如果设置警报以提醒用户有任务，则设置为 true。
lastModifiedDateTime	DateTimeOffset	上次修改任务的日期和时间。默认情况下，它采用 UTC 格式。你可以在请求标头中提供自定义时区。属性值使用 ISO 8601 格式，并始终处于 UTC 时间。例如，2020 年 1 月 1 日午夜 UTC 如下所示：“2020-01-01T00：00：00Z”。
recurrence	patternedRecurrence	任务的定期模式。
reminderDateTime	dateTimeTimeZone	提醒警报发出任务发生提醒的日期和时间。
状态	任务状态	指示任务的状态或进度。可取值为：`notStarted`、`inProgress`、`completed`、`waitingOnOthers`、`deferred`。
title	String	任务的简要说明。

关系

关系	类型	说明
checklistItems	checklistItem 集合	链接到任务的 checklistItems 的集合。
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"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}

todoTask 资源类型

方法

属性

关系

JSON 表示形式

反馈