Использование API Списка дел Microsoft

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Используйте интерфейс API To Do Microsoft Graph, использующий todoTask, для создания приложения, подключающегося к задачам в клиентах Microsoft To Do. Создавайте разнообразные возможности с задачами, например следующие:

• Создавайте задачи из рабочего процесса приложения, например из электронной почты или уведомлений, и сохраняйте их в To Do. Используйте объект linkedResource, чтобы сохранить ссылку, ведущую к вашему приложению.
• Синхронизируйте существующие задачи приложения с помощью To Do и создайте единое представление задач, чтобы лучше определить приоритеты и управлять ими.
• Управляйте задачами To Do в пользовательском бизнес-приложении.

API поддерживает делегированные разрешения и разрешения приложений.

Прежде чем приступить к работе с API To Do, ознакомьтесь с ресурсами и их связью между собой.

Список задач

В этом наборе API список задач представлен ресурсом todoTaskList, который является логическим контейнером ресурсов todoTask. В настоящее время вы можете создавать задачи только в списке задач. Чтобы получить все свои списки задач, выполните следующий HTTP-запрос:

GET /me/todo/lists

Задача

В этом наборе API задача представлена ресурсом 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