Planner

Элементы группы Office 365 → Planner предназначены для работы с Microsoft Planner: планами, сегментами (колонками доски) и задачами. Все элементы размещаются внутри контейнера Microsoft 365.

Планы

• Создать план – создание плана в группе Microsoft 365.
• Получить план – получение плана по идентификатору.
• Получить список планов – получение планов группы.

Сегменты

• Создать сегмент – создание сегмента в плане.
• Получить список сегментов – получение сегментов плана.
• Получить задачи сегмента – получение задач сегмента.
• Удалить сегмент – удаление сегмента.

Задачи

• Создать задачу – создание задачи в сегменте.
• Получить задачу – получение задачи по идентификатору.
• Получить задачи – получение всех задач плана.
• Редактировать задачу – изменение названия, сроков, исполнителей и процента выполнения.
• Удалить задачу – удаление задачи.

Необходимые разрешения Microsoft Graph: Tasks.ReadWrite, Group.ReadWrite.All. Подробнее – в разделе Настройка доступа к Microsoft 365.

Структура Planner

Каждый план принадлежит группе Microsoft 365. План состоит из сегментов – колонок доски («К выполнению», «В работе», «Готово»), в сегментах находятся задачи.

Типовая цепочка: Получить группу → Получить список планов → Получить список сегментов → Создать задачу.

Важно: Элементы Редактировать задачу, Удалить задачу и Удалить сегмент принимают только объекты, полученные из Planner другими элементами пакета, – объект содержит отметку версии. Если задачу изменили после получения объекта, получите ее заново элементом Получить задачу.

Свойства объектов