任务资源类型 (已弃用)
命名空间：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 | 更新 任务 对象的属性。 |
| 删除任务 | None | 删除 任务 对象。 |
| 移动 | 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)"
}