新的&改进的 Microsoft Graph To Do API 公开预览了！

Posted 2021-04-01 Office365 Skill Up

原文分享了Microsoft 365 安全相关的文档，请点击左下方蓝色的阅读原文查看

 重磅 ·

Microsoft Graph To Do API 目前在beta版本中可用了。

Microsoft To Do 和 Planner构成了Microsoft 365任务的主干。To Do能够完美地管理个人的工作和生活任务而Planner最适合团队任务。通过API，开发者可以将他们应用中的任务带到To Do中，成为Microsoft 365用户生产力故事的核心部分。

微软提供了一个叫做todoTaskList实体，由todoTask实体的集合组成。同时，微软还引入了一个新的实体叫做linkedResource，它使任务能够完成。我们可以使用它来存储和显示返回到应用中的创建任务的项目的链接。

此API支持工作、学校和个人微软帐户，所需的权限为Tasks.ReadWrite，支持如下终结点：

内容	终结点
todoTaskList 实体的CRUD操作	/me/todo/lists
todoTask 实体的CRUD操作	/me/todo/lists/<listId>/tasks
linkedResource 实体的CRUD操作	/me/todo/lists/<listId>/tasks/<taskId>/linkedResources

下面是一些示例：

列出所有的任务列表

https://docs.microsoft.com/en-us/graph/api/todo-list-lists?WT.mc_id=M365-MVP-5000796&view=graph-rest-beta&tabs=http#examples

在一个任务列表中创建任务

https://docs.microsoft.com/en-us/graph/api/todotasklist-post-tasks?WT.mc_id=M365-MVP-5000796&view=graph-rest-beta#examples

创建链接资源

https://docs.microsoft.com/en-us/graph/api/todotask-post-linkedresources?WT.mc_id=M365-MVP-5000796&view=graph-rest-beta#examples

 用例 ·

微软预览项目中的合作伙伴使用To Do API来支持下面的用例：

1. 从应用的工作流中创建任务 (如邮件或提醒的任务)并保存到To Do中，这里别忘了使用linkedResource实体存储返回到应用的链接。

2. 将应用中现有的任务跟To Do同步并创建一个任务视图以更好地实现任务优先级和可管理性。

3. 在自己的业务应用中管理用户的To Do任务。

 弃用Outlook Tasks API ·

Microsoft To Do是经典的Outlook任务体验的升级版本，底层存储和基础架构是完全一致的，但To Do有着更优秀的体验。

微软将会从Outlook网页版开始，将Outlook任务体验替换为To Do。替换API是最关键的一个部分，微软建议开发者将现有使用Graph Outlook Tasks beta API的地方升级为新的To Do API。

Graph Outlook Tasks API将于2022年8月20日停止返回数据。

关于Microsoft 365 安全相关的信息，请阅读原文查找。