To Do Tasks API 的公开预览版发布

Posted 2022-01-19 Justin-Liu

在 Microsoft Ignite 2021 大会时，微软发布了全新的 To Do Tasks API 私有预览版。现在，微软宣布公开预览版在 beta 终结点上可用了。

Microsoft Graph 中的 Tasks API 可以帮助将来自多个源 (如 Outlook 电子邮件、Teams 聊天和 Office 文档) 的用户任务集中到一个地方。新的终结点 me/tasks 与我们的愿景一致，即用户的所有任务都在一个统一的位置。这些 API 允许您的应用程序检索、创建和组织用户的任务和任务列表。

Tasks API 之前提供了以下关键资源：

1. 任务列表 (Task List) ：表示任务资源的逻辑容器。当前只能在任务列表中创建任务。没有指定任务列表而创建的任务将在默认的任务列表中创建。
2. 任务 (Task)：表示一个任务，即可以跟踪和完成的工作、操作或项目
3. 检查清单项目 (Checklist Item)：表示一种方法，允许将任务划分为更小的步骤，以便更容易地跟踪和完成父任务
4. 相关资源 (Linked resource)：表示来自与任务相关的合作伙伴应用程序的项目。您可以使用它来存储信息，并链接回应用程序中的相关项目。

全新 Tasks API 的新增功能

除了现有 To Do API 中的功能外，微软还将新功能引入到 Tasks API 中。

1. 使用 AllTasks 终结点检索用户的所有任务
   /AllTasks 终结点允许应用程序在一个调用中获取一个用户的所有任务。此外，应用程序可以对任务属性应用odata过滤器，以只获取相关的任务。此外，应用程序可以使用此端点在默认任务列表中创建任务。
2. 使用检查清单项目 API 创建步骤
   应用程序现在可以将一个任务分成更小的步骤，这些步骤可以单独完成。这有助于更好地规划和跟踪复杂的任务。
3. 跨列表移动任务
   在任务上使用新的移动操作，应用程序现在可以跨列表移动任务。此外，通过支持不可变任务 id, id 在邮箱内的移动操作期间不会更改。

Tasks API 的使用说明

下面是一些如何在测试端点中使用 Tasks API 的示例

1. 如果您希望在没有任何过滤器的情况下查看邮箱中的所有任务，请调用如下所示的API

GET https://graph.microsoft.com/beta/me/tasks/AllTasks

2. 您还可以在此端点上使用任何筛选器。例如，如果您想要查看所有重要的任务，请调用以下API

GET https://graph.microsoft.com/beta/me/tasks/AllTasks$filter=importance eq high

3. 要获取特定列表中的任务，可以调用以下端点

GET https://graph.microsoft.com/beta/me/tasks/lists/list-id/tasks