outlookTask 资源类型（不推荐使用）

命名空间：microsoft.graph

重要

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

注意

Outlook 任务 API 已弃用，将于 2022 年 8 月 20 日停止返回数据。 请使用新的微软待办 API。 有关详细信息，请参阅微软待办 API（公共预览版）。

可用于跟踪工作项目的 Outlook 项目。

你可以使用任务来跟踪开始、截止和实际完成日期及时间、其进度或状态、它是否为定期任务并且需要提醒。

outlookTask 资源中与日期相关的属性包括：

• completedDateTime
• createdDateTime
• dueDateTime
• lastModifiedDateTime
• reminderDateTime
• startDateTime

默认情况下，POST、GET、PATCH 和完成操作会在 UTC 的 REST 响应中返回与日期相关的属性。 你可以使用 Prefer: outlook.timezone 标头将响应中的所有与日期相关的属性都表示为与 UTC 不同的时区。 以下示例在对应响应的 EST 中返回与日期相关的属性：

Prefer: outlook.timezone="Eastern Standard Time"

方法

方法	返回类型	说明
获取 outlookTask	outlookTask	获取用户邮箱中的 Outlook 任务的属性和关系。
更新	outlookTask	更改 Outlook 任务的可写属性。
删除	无	删除用户邮箱中的指定任务。
完成	outlookTask 集合	完成 Outlook 任务，它将 completedDateTime 属性设置为当前日期，并将 status 属性设置为 completed。
附件
列出附件	attachment 集合	获取 Outlook 任务的所有附件。
添加附件	附件	向任务添加作为附件的文件、项目（消息、事件或联系人）或文件链接。
扩展属性
创建单值扩展属性	outlookTask	在新建或现有 Outlook 任务中创建一个或多个单值扩展属性。
获取具有单值扩展属性的任务	outlookTask	通过使用 $expand 或 $filter 获取包含单值扩展属性的 Outlook 任务。
创建多值扩展属性	outlookTask	在新建或现有的 Outlook 任务中创建一个或多个多值扩展属性。
获取具有多值扩展属性的任务	outlookTask	使用 $expand 获取包含一个多值扩展属性的 Outlook 任务。

属性

属性	类型	说明
assignedTo	String	Outlook 中已为其分配任务的人员姓名。只读。
body	itemBody	通常包含有关任务的信息的任务正文。 请注意，仅支持 HTML 类型。
类别	String 集合	与任务关联的类别。 每个类别对应于用户定义的 outlookCategory 的 displayName 属性。
changeKey	String	任务的版本。
completedDateTime	dateTimeTimeZone	在指定时区内完成任务的日期。
createdDateTime	DateTimeOffset	任务的创建日期和时间。 默认情况下，它采用 UTC 格式。 你可以在请求标头中提供自定义时区。 属性值使用 ISO 8601 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
dueDateTime	dateTimeTimeZone	要在指定时区内完成任务的日期。
hasAttachments	Boolean	如果任务包含附件，则设置为 true。
id	String	任务的唯一标识符。 By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. To change this behavior, use the Prefer: IdType="ImmutableId" header. See Get immutable identifiers for Outlook resources for more information. 只读。
importance	importance	事件的重要性。 可取值为：low、normal、high。
isReminderOn	Boolean	如果设置警报以提醒用户有任务，则设置为 true。
lastModifiedDateTime	DateTimeOffset	上次修改任务的日期和时间。 默认情况下，它采用 UTC 格式。 你可以在请求标头中提供自定义时区。 属性值使用 ISO 8601 格式，并始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
Owner	String	任务创建者的姓名。
parentFolderId	String	任务的父文件夹的唯一标识符。
定期	patternedRecurrence	任务的定期模式。
reminderDateTime	dateTimeTimeZone	提醒警报发出任务发生提醒的日期和时间。
敏感度	敏感度	指示任务的隐私级别。 可取值为：normal、personal、private、confidential。
startDateTime	dateTimeTimeZone	要在指定时区内开始执行任务的日期。
状态	任务状态	指示任务的状态或进度。 可取值为：notStarted、inProgress、completed、waitingOnOthers、deferred。
主题	String	任务的简要说明或标题。

关系

关系	类型	说明
attachments	attachment 集合	任务的 fileAttachment、itemAttachment 和 referenceAttachment 附件的集合。 只读。 可为空。
multiValueExtendedProperties	multiValueLegacyExtendedProperty 集合	为任务定义的多值扩展属性的集合。只读。可为 NULL。
singleValueExtendedProperties	singleValueLegacyExtendedProperty collection	为任务定义的单值扩展属性的集合。只读。可为 NULL。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "assignedTo": "String",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "categories": ["String"],
  "changeKey": "String",
  "completedDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "id": "String (identifier)",
  "importance": "string",
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "owner": "String",
  "parentFolderId": "String",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "sensitivity": "string",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "status": "string",
  "subject": "String"
}