命名空间：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 | None | 删除 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 | 任务的重要性。 可取值为：low、normal、high。 可能的值包括 low、normal、high。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改任务的日期和时间。 默认情况下，它采用 UTC 格式。 你可以在请求标头中提供自定义时区。 属性值使用 ISO 8601 格式，并始终处于 UTC 时间。 例如，2020 年 1 月 1 日午夜 UTC 如下所示：“2020-01-01T00：00：00Z”。 |
| 观点 | taskViewpoint | 用户个人属性，例如 reminderDateTime 和 categories。 |
| recurrence | patternedRecurrence | 任务的定期模式。 |
| startDateTime | dateTimeTimeZone | 要在指定时区内开始执行任务的日期。 |
| 状态 | taskStatus_v2 | 指示任务的状态或进度。 可能的值为： notStarted、 inProgress、 completed、unknownFutureValue。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 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)"
}