Использование API Microsoft To Do
Используйте API To Do Microsoft Graph для создания приложения, подключающегося к задачам в клиентах Microsoft To Do. Создавайте разнообразные возможности с задачами, например следующие:
- Создавайте задачи из рабочего процесса приложения, например из электронной почты или уведомлений, и сохраняйте их в To Do. Используйте объект linkedResource, чтобы сохранить ссылку, ведущую к вашему приложению.
- Синхронизируйте существующие задачи приложения с помощью To Do и создайте единое представление задач, чтобы лучше определить приоритеты и управлять ими.
- Управляйте задачами To Do в пользовательском бизнес-приложении.
API поддерживает делегированные разрешения и разрешения приложений.
Прежде чем приступить к работе с API To Do, ознакомьтесь с ресурсами и их связью между собой.
Список задач
Объект todoTaskList представляет логический контейнер ресурсов todoTask. В настоящее время вы можете создавать задачи только в списке задач. Чтобы получить все свои списки задач, выполните следующий HTTP-запрос:
GET /me/todo/lists
Задача
Объект todoTask представляет задачу, т. е. рабочий или личный элемент, который можно отследить и завершить. Чтобы получить свои задачи из списка задач, выполните следующий HTTP-запрос:
GET /me/todo/lists/{todoTaskListId}/tasks
Элемент контрольного списка
ChecklistItem представляет подзадачу в более крупном элементе todoTask. ChecklistItem позволяет разделить сложную задачу на более удобные задачи меньшего размера. Чтобы получить объект checklistItem из задачи, выполните следующий HTTP-запрос.
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItems}
Связанный ресурс
Объект linkedResource представляет любой элемент из партнерского приложения, связанный с задачей, например такой элемент, как письмо, из которого создана задача. Вы можете использовать его для хранения данных и связи с соответствующим элементом в приложении. Чтобы получить связанный ресурс из задачи, выполните следующий HTTP-запрос:
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/linkedresources/{linkedResourceId}
Отслеживание изменений с помощью разностного запроса
Для повышения производительности вы можете использовать локальный кэш объектов и периодически синхронизировать локальный кэш с сервером, используя разностный запрос.
Разностный запрос поддерживают следующие ресурсы API To Do:
- Коллекция todoTask в списке задач
- todoTaskList