使用建立在 Microsoft Graph 基础任务上的待办事项 API (已废弃)

重要

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

警告

从 2022 年 5 月 31 日开始， 基于 baseTask 构建的未完成的 API 集已弃用，并且将于 2022 年 8 月 31 日停止返回数据。 请使用基于 todoTask 构建的 API 集。

使用 Microsoft Graph 待办事项 API 创建与其邮箱中用户的任务连接的应用。 使用任务构建各种体验，如下所示：

• 从应用的工作流（例如，从电子邮件或通知）创建任务，并将其保存到微软待办中。 使用 linkedResource 实体将链接存储回你的应用。
• 将应用的现有任务与微软待办进行同步，并创建单个任务视图，以便更好地确定优先顺序和实施管理。
• 在自定义业务应用程序中管理微软待办任务。
• 在任务上创建 checklistItems ，以在较小的步骤中分解复杂任务。

目前，API 仅支持由已登录用户委派的权限。

在开始使用微软待办 API 之前，请查看资源以及它们之间的关系。

任务列表

在此 API 集中，任务列表由 baseTaskList 表示，它是 baseTask 资源的逻辑容器。 目前只能在任务列表中创建任务。 在默认任务列表中创建未指定列表的情况下创建的任务。 若要获取所有任务列表，请执行以下 HTTP 请求：

GET /me/tasks/lists

任务

在此 API 集中，任务由 baseTask 资源表示，该资源是可跟踪和完成的工作项或个人项目。 若要从任务列表中获取任务，请执行以下 HTTP 请求：

GET /me/tasks/lists/{taskListId}/tasks

清单项

checklistItem 表示有助于以更小的步骤分解复杂任务的项。 若要从任务获取 checklistItem，请发出以下 HTTP 请求：

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/checklistItems/{checklistItems}

链接的资源

linkedResource 表示与任务相关的合作伙伴应用程序中的任何项目，例如从中创建任务的电子邮件。 可以使用它来将信息和链接存储回你的应用中的相关项。 若要从任务获取链接的资源，请执行以下 HTTP 请求：

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/linkedresources/{linkedResourceId}

使用 delta 查询跟踪更改

出于性能原因，可能需要维护对象的本地缓存，并使用 delta 查询定期将本地缓存与服务器同步。

以下微软待办 API 资源支持 delta 查询：

• 任务列表中的 baseTask 集合
• baseTaskList