Поделиться через


Microsoft To-Do (бизнес)

Microsoft To-Do — это интеллектуальное приложение для управления задачами, которое упрощает планирование и управление днями. Подключитесь к Microsoft To-Do для управления задачами из различных служб. Вы можете выполнять такие действия, как создание задач.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Стандарт Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Стандарт Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Microsoft
URL Поддержка Microsoft LogicApps
Поддержка Microsoft Power Automate
Поддержка Microsoft Power Apps
Метаданные соединителя
Publisher Microsoft
Website https://todo.microsoft.com/tasks/

Известные проблемы и ограничения

Для API Do есть большинство возможностей задачи Outlook . Обратите внимание, что сущность outlookTaskGroup, расширенные свойства и назначенныеTo, свойства владельца сущности outlookTask не будут доступны в API Do.

Нерекомендуция API задач Outlook

API-интерфейсы задач Graph Outlook перестают возвращать данные после 20 февраля 2023 г.

Операции, перечисленные здесь , будут затронуты нерекомендуемым API и будут остановлены для возврата данных после 20 февраля 2023 года.


Операции, перечисленные здесь , не будут затронуты нерекомендуемым API.


Devblogs в выпуске API To Do

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд
Частота опросов триггеров 1 120 секунд

Действия

Вывод списка to-doпо папке (V2)

Эта операция используется для получения всех to-doиз определенного списка.

Вывод списка to-doпо папке [DEPRECATED]

Это действие устарело. Вместо этого используйте список to-doпо папке (V2).

Эта операция используется для получения всех to-doиз определенного списка.

Добавление to-do (V3)

Эта операция используется для создания to-do в указанном списке to-do.

Добавление to-do (версия 2) [не рекомендуется]

Это действие устарело. Вместо этого используйте to-do (V3).

Эта операция используется для создания to-do в указанном списке to-do (по умолчанию используется To-Do).

Добавление to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте to-do (V3).

Эта операция используется для создания to-do в указанном списке to-do (по умолчанию используется To-Do).

Обновление to-do (версия 2)

Эта операция используется для обновления определенной to-do.

Обновление to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте обновление to-do (версия 2 ).

Эта операция используется для обновления определенной to-do.

Обновление списка to-do

Эта операция используется для обновления определенного списка to-do.

Получение to-do (V3)

Эта операция используется для получения to-do с заданным идентификатором.

Получение to-do (версия 2) [НЕ РЕКОМЕНДУЕТСЯ]

Это действие устарело. Вместо этого используйте to-do (V3).

Эта операция используется для получения to-do с заданным идентификатором.

Получение to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте to-do (V3).

Эта операция используется для получения to-Do с заданным идентификатором.

Получение списка to-do (версия 2)

Эта операция используется для получения определенного списка to-do.

Получение списка to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте список to-do (V2).

Эта операция используется для получения определенного списка to-do.

Создание списка to-do (версия 2)

Эта операция используется для создания нового списка to-do.

Создание списка to-do [устарело]

Это действие устарело. Вместо этого используйте список to-do (V2).

Эта операция используется для создания нового списка to-do.

Список всех to-do[не рекомендуется]

Эта операция используется для получения всех to-doиз всех списков.

Список всех списков to-do (версия 2)

Возвращает список всех списков to-do.

Список всех списков to-do [DEPRECATED]

Это действие устарело. Вместо этого используйте список всех to-do списков (V2 ).

Возвращает список всех списков to-do.

Удаление to-do (версия 2)

Эта операция используется для удаления задачи.

Удаление to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте команду Delete to-do (V2).

Эта операция используется для удаления задачи.

Удаление списка to-do

Эта операция используется для удаления определенного списка to-do.

Вывод списка to-doпо папке (V2)

Эта операция используется для получения всех to-doиз определенного списка.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Первое число
$top integer

Общее количество записей для получения (по умолчанию = 10, максимум = 999).

Возвращаемое значение

response
array of ToDo_V2

Вывод списка to-doпо папке [DEPRECATED]

Это действие устарело. Вместо этого используйте список to-doпо папке (V2).

Эта операция используется для получения всех to-doиз определенного списка.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Первое число
$top integer

Общее количество записей для получения (по умолчанию = 10, максимум = 999).

Возвращаемое значение

response
array of ToDo

Добавление to-do (V3)

Эта операция используется для создания to-do в указанном списке to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Срок
dateTime date-time

YYYY-MM-DDThh:mm:ss

Напоминание Date-Time
dateTime date-time

YYYY-MM-DDThh:mm:ss

Важность
importance string

Низкий, нормальный или высокий.

Название
title True string

Краткое описание или название to-do.

Состояние
status string

Указывает состояние или ход выполнения to-do — не запущен, выполняется, завершено, ожидает других или отложено.

Content
content html

Содержимое элемента.

Напоминание
isReminderOn boolean

Значение true, если для оповещения задано напоминание пользователю о to-do.

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo_V2

Добавление to-do (версия 2) [не рекомендуется]

Это действие устарело. Вместо этого используйте to-do (V3).

Эта операция используется для создания to-do в указанном списке to-do (по умолчанию используется To-Do).

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId string

Список действий

Срок
DateTime date-time

ГГГГ-MM-DD или ГГГГ-ММ-ДДThh:mm:ssZ (обратите внимание, что часть времени будет игнорироваться)

Напоминание Date-Time
DateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Дата начала
DateTime date-time

ГГГГ-MM-DD или ГГГГ-ММ-ДДThh:mm:ssZ (обратите внимание, что часть времени будет игнорироваться)

Важность
Importance string

Низкий, нормальный или высокий.

Тема
Subject True string

Краткое описание или название to-do.

Состояние
Status string

Указывает состояние или ход выполнения to-do — не запущен, выполняется, завершено, ожидает других или отложено.

Чувствительность
Sensitivity string

Указывает уровень конфиденциальности события.

Content
Content html

Содержимое.

Категории
Categories array of string

Коллекция имен категорий, связанных с to-do.

Напоминание
IsReminderOn boolean

Значение true, если для оповещения задано напоминание пользователю о to-do.

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDoHtml

Добавление to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте to-do (V3).

Эта операция используется для создания to-do в указанном списке to-do (по умолчанию используется To-Do).

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId string

Список действий

Срок
DateTime date-time

ГГГГ-MM-DD или ГГГГ-ММ-ДДThh:mm:ssZ (обратите внимание, что часть времени будет игнорироваться)

Напоминание Date-Time
DateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Дата начала
DateTime date-time

ГГГГ-MM-DD или ГГГГ-ММ-ДДThh:mm:ssZ (обратите внимание, что часть времени будет игнорироваться)

Важность
Importance string

Низкий, нормальный или высокий.

Тема
Subject True string

Краткое описание или название to-do.

Состояние
Status string

Указывает состояние или ход выполнения to-do — не запущен, выполняется, завершено, ожидает других или отложено.

Чувствительность
Sensitivity string

Указывает уровень конфиденциальности события.

Тип контента
ContentType string

Text=0, HTML=1

Content
Content string

Текст или HTML-содержимое.

Категории
Categories array of string

Коллекция имен категорий, связанных с to-do.

Напоминание
IsReminderOn boolean

Значение true, если для оповещения задано напоминание пользователю о to-do.

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo

Обновление to-do (версия 2)

Эта операция используется для обновления определенной to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Задача в приложении "Список дел"
id True string

Задача в приложении "Список дел"

Срок
dateTime date-time

YYYY-MM-DDThh:mm:ss

Напоминание Date-Time
dateTime date-time

YYYY-MM-DDThh:mm:ss

Важность
importance string

Низкий, нормальный или высокий.

Название
title string

Краткое описание или название to-do.

Состояние
status string

Указывает состояние или ход выполнения to-do — не запущен, выполняется, завершено, ожидает других или отложено.

Content
content html

Содержимое элемента.

Напоминание
isReminderOn boolean

Значение true, если для оповещения задано напоминание пользователю о to-do.

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo_V2

Обновление to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте обновление to-do (версия 2 ).

Эта операция используется для обновления определенной to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Задача в приложении "Список дел"
id True string

Задача в приложении "Список дел"

Срок
DateTime date-time

ГГГГ-MM-DD или ГГГГ-ММ-ДДThh:mm:ssZ (обратите внимание, что часть времени будет игнорироваться)

Напоминание Date-Time
DateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Дата начала
DateTime date-time

ГГГГ-MM-DD или ГГГГ-ММ-ДДThh:mm:ssZ (обратите внимание, что часть времени будет игнорироваться)

Важность
Importance string

Низкий, нормальный или высокий.

Тема
Subject string

Краткое описание или название to-do.

Состояние
Status string

Указывает состояние или ход выполнения to-do — не запущен, выполняется, завершено, ожидает других или отложено.

Чувствительность
Sensitivity string

Указывает уровень конфиденциальности события.

Тип контента
ContentType string

Text=0, HTML=1

Content
Content string

Текст или HTML-содержимое.

Категории
Categories array of string

Коллекция имен категорий, связанных с to-do.

Напоминание
IsReminderOn boolean

Значение true, если для оповещения задано напоминание пользователю о to-do.

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo

Обновление списка to-do

Эта операция используется для обновления определенного списка to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Имя
displayName True string

Имя списка

Возвращаемое значение

Список To-Do Майкрософт.

Тело
TodoList_V2

Получение to-do (V3)

Эта операция используется для получения to-do с заданным идентификатором.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Задача в приложении "Список дел"
id True string

Задача в приложении "Список дел"

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo_V2

Получение to-do (версия 2) [НЕ РЕКОМЕНДУЕТСЯ]

Это действие устарело. Вместо этого используйте to-do (V3).

Эта операция используется для получения to-do с заданным идентификатором.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Задача в приложении "Список дел"
id True string

Задача в приложении "Список дел"

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo

Получение to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте to-do (V3).

Эта операция используется для получения to-Do с заданным идентификатором.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор действия
id True string

Идентификатор действия

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo

Получение списка to-do (версия 2)

Эта операция используется для получения определенного списка to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Возвращаемое значение

Список To-Do Майкрософт.

Тело
TodoList_V2

Получение списка to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте список to-do (V2).

Эта операция используется для получения определенного списка to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
id True string

Список действий

Возвращаемое значение

Список To-Do Майкрософт.

Тело
TodoList

Создание списка to-do (версия 2)

Эта операция используется для создания нового списка to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Имя
displayName True string

Имя списка

Возвращаемое значение

Список To-Do Майкрософт.

Тело
TodoList_V2

Создание списка to-do [устарело]

Это действие устарело. Вместо этого используйте список to-do (V2).

Эта операция используется для создания нового списка to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Имя
name True string

Имя списка

Возвращаемое значение

Список To-Do Майкрософт.

Тело
TodoList

Список всех to-do[не рекомендуется]

Эта операция используется для получения всех to-doиз всех списков.

Параметры

Имя Ключ Обязательно Тип Описание
Первое число
$top integer

Общее количество записей для получения (по умолчанию = 10, максимум = 999).

Возвращаемое значение

response
array of ToDo

Список всех списков to-do (версия 2)

Возвращает список всех списков to-do.

Возвращаемое значение

Список всех списков to-do [DEPRECATED]

Это действие устарело. Вместо этого используйте список всех to-do списков (V2 ).

Возвращает список всех списков to-do.

Возвращаемое значение

Удаление to-do (версия 2)

Эта операция используется для удаления задачи.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Задача в приложении "Список дел"
id True string

Задача в приложении "Список дел"

Удаление to-do [не рекомендуется]

Это действие устарело. Вместо этого используйте команду Delete to-do (V2).

Эта операция используется для удаления задачи.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Задача в приложении "Список дел"
id True string

Задача в приложении "Список дел"

Удаление списка to-do

Эта операция используется для удаления определенного списка to-do.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Триггеры

При обновлении to-do [не рекомендуется]

Активирует при обновлении to-do.

При обновлении to-do в определенной папке (версия 2)

Активирует при обновлении to-do в определенной папке.

При обновлении to-do в определенной папке [DEPRECATED]

Это действие устарело. Используйте, если вместо этого обновляется to-do в определенной папке (V2).

Активирует при обновлении to-do в определенной папке.

При создании нового to-do [не рекомендуется]

Активирует при создании новой to-do.

При создании нового to-do в определенной папке (версия 2)

Активирует при создании нового to-do в определенной папке.

При создании новой to-do в определенной папке [DEPRECATED]

Это действие устарело. Используйте, если вместо этого создается новая to-do в определенной папке (V2).

Активирует при создании нового to-do в определенной папке.

При обновлении to-do [не рекомендуется]

Активирует при обновлении to-do.

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo

При обновлении to-do в определенной папке (версия 2)

Активирует при обновлении to-do в определенной папке.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo_V2

При обновлении to-do в определенной папке [DEPRECATED]

Это действие устарело. Используйте, если вместо этого обновляется to-do в определенной папке (V2).

Активирует при обновлении to-do в определенной папке.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo

При создании нового to-do [не рекомендуется]

Активирует при создании новой to-do.

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo

При создании нового to-do в определенной папке (версия 2)

Активирует при создании нового to-do в определенной папке.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo_V2

При создании новой to-do в определенной папке [DEPRECATED]

Это действие устарело. Используйте, если вместо этого создается новая to-do в определенной папке (V2).

Активирует при создании нового to-do в определенной папке.

Параметры

Имя Ключ Обязательно Тип Описание
Список действий
folderId True string

Список действий

Возвращаемое значение

Объект Microsoft To-Do.

Тело
ToDo

Определения

Список задач

Объект Microsoft To-Do.

Имя Путь Тип Описание
Идентификатор
id string

Уникальный идентификатор to-do.

Создан Date-Time
createdDateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Изменены Date-Time
lastModifiedDateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Категории
categories array of string

Коллекция имен категорий, связанных с to-do.

Assigned To
assignedTo string

Имя лица, назначаемого to-do.

Тип контента
body.contentType string

Text=0, HTML=1

Content
body.content string

Текст или HTML-содержимое.

Date-Time
completedDateTime.dateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Date
dueDateTime.dateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Важность
importance string

Низкий, нормальный или высокий.

Напоминание о
isReminderOn boolean

Значение true, если для оповещения задано напоминание пользователю о to-do.

Владелец
owner string

Имя пользователя, создавшего to-do.

Идентификатор родительской папки
parentFolderId string

Уникальный идентификатор родительской папки.

Date-Time
reminderDateTime.dateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Date
startDateTime.dateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Состояние
status string

Указывает состояние или ход выполнения to-do — не запущен, выполняется, завершено, ожидает других или отложено.

Тема
subject string

Краткое описание или название to-do.

ToDoHtml

Объект Microsoft To-Do.

Имя Путь Тип Описание
Идентификатор
id string

Уникальный идентификатор to-do.

Создан Date-Time
createdDateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Изменены Date-Time
lastModifiedDateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Категории
categories array of string

Коллекция имен категорий, связанных с to-do.

Assigned To
assignedTo string

Имя лица, назначаемого to-do.

Content
body.content html

Содержимое.

Date-Time
completedDateTime.dateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Date
dueDateTime.dateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Важность
importance string

Низкий, нормальный или высокий.

Напоминание о
isReminderOn boolean

Значение true, если для оповещения задано напоминание пользователю о to-do.

Владелец
owner string

Имя пользователя, создавшего to-do.

Идентификатор родительской папки
parentFolderId string

Уникальный идентификатор родительской папки.

Date-Time
reminderDateTime.dateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Date
startDateTime.dateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Состояние
status string

Указывает состояние или ход выполнения to-do — не запущен, выполняется, завершено, ожидает других или отложено.

Тема
subject string

Краткое описание или название to-do.

TodoList

Список To-Do Майкрософт.

Имя Путь Тип Описание
Идентификатор
id string

Уникальный идентификатор списка to-do.

Имя
name string

Имя списка to-do.

Значение по умолчанию
isDefaultFolder boolean

Значение true, если это список to-do по умолчанию.

TodoList_V2

Список To-Do Майкрософт.

Имя Путь Тип Описание
Идентификатор
id string

Уникальный идентификатор списка to-do.

Имя
displayName string

Имя списка to-do.

Известное имя
wellknownListName string

Свойство, указывающее хорошо известное имя списка, если данный список является хорошо известным списком. Возможные значения: none, defaultList, flaggedEmails, unknownFutureValue.

Владелец
isOwner boolean

Значение true, если пользователь является владельцем заданного списка задач.

Общий доступ
isShared boolean

Значение true, если список задач предоставлен другим пользователям.

ToDo_V2

Объект Microsoft To-Do.

Имя Путь Тип Описание
Идентификатор
id string

Уникальный идентификатор to-do.

Создан Date-Time
createdDateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Изменены Date-Time
lastModifiedDateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Тип контента
body.contentType string

Тип контента. Возможные значения : текст и html.

Content
body.content string

Содержимое элемента.

Изменены Date-Time
bodyLastModifiedDateTime date-time

ГГГГ-ММ-DDThh:mm:ssZ (формат UTC)

Date
completedDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss

Date
dueDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss

Важность
importance string

Низкий, нормальный или высокий.

Напоминание о
isReminderOn boolean

Значение true, если для оповещения задано напоминание пользователю о to-do.

Date-Time
reminderDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss

Состояние
status string

Указывает состояние или ход выполнения to-do — не запущен, выполняется, завершено, ожидает других или отложено.

Название
title string

Краткое описание или название to-do.