命名空间：microsoft.graph
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 集合 | 与任务关联的类别。 每个类别对应于用户定义的 outlookCategory 的 displayName 属性。 |
| completedDateTime | dateTimeTimeZone | 任务完成的指定时区中的日期和时间。 |
| createdDateTime | DateTimeOffset | 任务的创建日期和时间。 默认情况下，它采用 UTC 格式。 你可以在请求标头中提供自定义时区。 属性值使用 ISO 8601 格式。 例如，2020 年 1 月 1 日午夜 UTC 如下所示：“2020-01-01T00：00：00Z”。 |
| dueDateTime | dateTimeTimeZone | 任务要完成的指定时区中的日期和时间。 |
| hasAttachments | Boolean | 指示任务是否具有附件。 |
| 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 | 指定时区中要发生的任务的提醒警报的日期和时间。 |
| startDateTime | dateTimeTimeZone | 计划任务开始的指定时区中的日期和时间。 |
| 状态 | 任务状态 | 指示任务的状态或进度。 可取值为：notStarted、inProgress、completed、waitingOnOthers、deferred。 |
| title | String | 任务的简要说明。 |
可以使用 从 Microsoft Purview 门户导出内容搜索结果中所述的 PST 下载导出任务。 可以在“To Do API 概述”中引用属性与导出的 PST 文件中的属性之间的todoTask映射。
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 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"
},
"status": "String",
"title": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)"
}