通过

Microsoft To-Do （商业）

Microsoft To-Do 是一种智能任务管理应用，可便于规划和管理你的一天。 连接到Microsoft To-Do 以从各种服务管理任务。 可以执行创建任务等作。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 标准 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 标准 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 标准 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Microsoft
URL Microsoft LogicApps 支持
Microsoft Power Automate 支持
Microsoft Power Apps 支持
连接器元数据
发布者 Microsoft
网站 https://todo.microsoft.com/tasks/

已知问题和限制

To Do API 具有大多数 Outlook 任务 功能。 请注意， outlookTaskGroup 实体、扩展属性和 assignedTo、 outlookTask 实体 的所有者属性在待办 API 中不可用。

弃用 Outlook 任务 API

Graph Outlook 任务 API 将在 2023 年 2 月 20 日之后停止返回数据。

此处列出的作将受到 API 弃用的影响，并且将在 2023 年 2 月 20 日之后停止返回数据。

此处列出的作 不受 API 弃用的影响。

待办事项 API 版本的 Devblogs

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒
触发器轮询的频率 1 120 秒

操作

列出 to-do文件夹 [已弃用]

此作已弃用。 请改用列表 to-do文件夹（V2）。

此作用于从特定列表中检索所有 to-do。
列出所有 to-do 列表 [已弃用]

此作已弃用。 请改用“列出所有 to-do 列表”（V2）。

返回所有 to-do 列表的列表。
列出所有 to-do 列表 （V2）

返回所有 to-do 列表的列表。
列出所有 to-do的 [已弃用]

此作用于从所有列表中检索所有 to-do。
创建 to-do 列表 [已弃用]

此作已弃用。 请改用“创建 to-do 列表”（V2）。

此作用于创建新的 to-do 列表。
创建 to-do 列表（V2）

此作用于创建新的 to-do 列表。
删除 to-do [已弃用]

此作已弃用。 请改用 Delete to-do （V2）。

此作用于删除任务。
删除 to-do 列表

此作用于删除特定 to-do 列表。
删除 to-do （V2）

此作用于删除任务。
按文件夹列出 to-do（V2）

此作用于从特定列表中检索所有 to-do。
更新 to-do [已弃用]

此作已弃用。 请改用 Update to-do （V2）。

此作用于更新特定的 to-do。
更新 to-do 列表

此作用于更新特定 to-do 列表。
更新 to-do （V2）

此作用于更新特定的 to-do。
添加 to-do [已弃用]

此作已弃用。 请改用“添加 to-do”（V3）。

此作用于在指定的 to-do 列表中创建 to-do（默认为 To-Do）。
添加 to-do （V2） [已弃用]

此作已弃用。 请改用“添加 to-do”（V3）。

此作用于在指定的 to-do 列表中创建 to-do（默认为 To-Do）。
添加 to-do（V3）

此作用于在指定的 to-do 列表中创建 to-do。
获取 to-do [已弃用]

此作已弃用。 请改用“获取 to-do”（V3）。

此作用于获取具有给定 ID 的 to-Do。
获取 to-do 列表 [已弃用]

此作已弃用。 请改用“获取 to-do 列表”（V2）。

此作用于获取特定 to-do 列表。
获取 to-do 列表 （V2）

此作用于获取特定 to-do 列表。
获取 to-do （V2） [已弃用]

此作已弃用。 请改用“获取 to-do”（V3）。

此作用于获取具有给定 ID 的 to-do。
获取 to-do（V3）

此作用于获取具有给定 ID 的 to-do。

列出 to-do文件夹 [已弃用]

操作 ID:
ListToDosByFolder

此作已弃用。 请改用列表 to-do文件夹（V2）。

此作用于从特定列表中检索所有 to-do。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
Top Count
 $top integer

要检索的条目总数（默认值 = 10，最大值 = 999）。

返回

response
array of ToDo

列出所有 to-do 列表 [已弃用]

操作 ID:
GetAllTodoLists

此作已弃用。 请改用“列出所有 to-do 列表”（V2）。

返回所有 to-do 列表的列表。

返回

response
array of TodoList

列出所有 to-do 列表 （V2）

操作 ID:
GetAllTodoListsV2

返回所有 to-do 列表的列表。

返回

response
array of TodoList_V2

列出所有 to-do的 [已弃用]

操作 ID:
ListAllToDos

此作用于从所有列表中检索所有 to-do。

参数

名称 密钥 必需 类型 说明
Top Count
 $top integer

要检索的条目总数（默认值 = 10，最大值 = 999）。

返回

response
array of ToDo

创建 to-do 列表 [已弃用]

操作 ID:
CreateToDoList

此作已弃用。 请改用“创建 to-do 列表”（V2）。

此作用于创建新的 to-do 列表。

参数

名称 密钥 必需 类型 说明
Name
 name True string

列表名称

返回

Microsoft To-Do 列表。

Body
TodoList

创建 to-do 列表（V2）

操作 ID:
CreateToDoListV2

此作用于创建新的 to-do 列表。

参数

名称 密钥 必需 类型 说明
Name
 displayName True string

列表名称

返回

Microsoft To-Do 列表。

Body
TodoList_V2

删除 to-do [已弃用]

操作 ID:
DeleteToDo

此作已弃用。 请改用 Delete to-do （V2）。

此作用于删除任务。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
待办事项任务
 id True string

待办事项任务

删除 to-do 列表

操作 ID:
DeleteToDoList

此作用于删除特定 to-do 列表。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表

删除 to-do （V2）

操作 ID:
DeleteToDoV2

此作用于删除任务。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
待办事项任务
 id True string

待办事项任务

按文件夹列出 to-do（V2）

操作 ID:
ListToDosByFolderV2

此作用于从特定列表中检索所有 to-do。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
Top Count
 $top integer

要检索的条目总数（默认值 = 10，最大值 = 999）。

返回

response
array of ToDo_V2

更新 to-do [已弃用]

操作 ID:
UpdateToDo

此作已弃用。 请改用 Update to-do （V2）。

此作用于更新特定的 to-do。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
待办事项任务
 id True string

待办事项任务
截止日期
 DateTime date-time

YYYY-MM-DD 或 YYYY-MM-DDThh：mm：ssZ（请注意时间部分将被忽略）
提醒 Date-Time
 DateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
开始日期
 DateTime date-time

YYYY-MM-DD 或 YYYY-MM-DDThh：mm：ssZ（请注意时间部分将被忽略）
重要性
 Importance string

低、正常或高。
Subject
 Subject string

to-do的简要说明或标题。
状态
 Status string

指示 to-do 的状态或进度 - 未启动、正在进行、已完成、等待他人或延迟。
Sensitivity
 Sensitivity string

指示事件的隐私级别。
内容类型
 ContentType string

Text=0，HTML=1
Content
 Content string

文本或 HTML 内容。
类别
 Categories array of string

与 to-do关联的类别名称的集合。
提醒打开
 IsReminderOn boolean

如此 如果警报设置为提醒用户 to-do。

返回

Microsoft To-Do 对象。

Body
ToDo

更新 to-do 列表

操作 ID:
UpdateToDoList

此作用于更新特定 to-do 列表。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
Name
 displayName True string

列表名称

返回

Microsoft To-Do 列表。

Body
TodoList_V2

更新 to-do （V2）

操作 ID:
UpdateToDoV2

此作用于更新特定的 to-do。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
待办事项任务
 id True string

待办事项任务
截止日期
 dateTime date-time

YYYY-MM-DDThh:mm:ss
提醒 Date-Time
 dateTime date-time

YYYY-MM-DDThh:mm:ss
重要性
 importance string

低、正常或高。
Title
 title string

to-do的简要说明或标题。
状态
 status string

指示 to-do 的状态或进度 - 未启动、正在进行、已完成、等待他人或延迟。
Content
 content html

项的内容。
提醒打开
 isReminderOn boolean

如此 如果警报设置为提醒用户 to-do。

返回

Microsoft To-Do 对象。

Body
ToDo_V2

添加 to-do [已弃用]

操作 ID:
CreateToDo

此作已弃用。 请改用“添加 to-do”（V3）。

此作用于在指定的 to-do 列表中创建 to-do（默认为 To-Do）。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId string

To-do 列表
截止日期
 DateTime date-time

YYYY-MM-DD 或 YYYY-MM-DDThh：mm：ssZ（请注意时间部分将被忽略）
提醒 Date-Time
 DateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
开始日期
 DateTime date-time

YYYY-MM-DD 或 YYYY-MM-DDThh：mm：ssZ（请注意时间部分将被忽略）
重要性
 Importance string

低、正常或高。
Subject
 Subject True string

to-do的简要说明或标题。
状态
 Status string

指示 to-do 的状态或进度 - 未启动、正在进行、已完成、等待他人或延迟。
Sensitivity
 Sensitivity string

指示事件的隐私级别。
内容类型
 ContentType string

Text=0，HTML=1
Content
 Content string

文本或 HTML 内容。
类别
 Categories array of string

与 to-do关联的类别名称的集合。
提醒打开
 IsReminderOn boolean

如此 如果警报设置为提醒用户 to-do。

返回

Microsoft To-Do 对象。

Body
ToDo

添加 to-do （V2） [已弃用]

操作 ID:
CreateToDoV2

此作已弃用。 请改用“添加 to-do”（V3）。

此作用于在指定的 to-do 列表中创建 to-do（默认为 To-Do）。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId string

To-do 列表
截止日期
 DateTime date-time

YYYY-MM-DD 或 YYYY-MM-DDThh：mm：ssZ（请注意时间部分将被忽略）
提醒 Date-Time
 DateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
开始日期
 DateTime date-time

YYYY-MM-DD 或 YYYY-MM-DDThh：mm：ssZ（请注意时间部分将被忽略）
重要性
 Importance string

低、正常或高。
Subject
 Subject True string

to-do的简要说明或标题。
状态
 Status string

指示 to-do 的状态或进度 - 未启动、正在进行、已完成、等待他人或延迟。
Sensitivity
 Sensitivity string

指示事件的隐私级别。
Content
 Content html

内容。
类别
 Categories array of string

与 to-do关联的类别名称的集合。
提醒打开
 IsReminderOn boolean

如此 如果警报设置为提醒用户 to-do。

返回

Microsoft To-Do 对象。

Body
ToDoHtml

添加 to-do（V3）

操作 ID:
CreateToDoV3

此作用于在指定的 to-do 列表中创建 to-do。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
截止日期
 dateTime date-time

YYYY-MM-DDThh:mm:ss
提醒 Date-Time
 dateTime date-time

YYYY-MM-DDThh:mm:ss
重要性
 importance string

低、正常或高。
Title
 title True string

to-do的简要说明或标题。
状态
 status string

指示 to-do 的状态或进度 - 未启动、正在进行、已完成、等待他人或延迟。
Content
 content html

项的内容。
提醒打开
 isReminderOn boolean

如此 如果警报设置为提醒用户 to-do。

返回

Microsoft To-Do 对象。

Body
ToDo_V2

获取 to-do [已弃用]

操作 ID:
GetToDo

此作已弃用。 请改用“获取 to-do”（V3）。

此作用于获取具有给定 ID 的 to-Do。

参数

名称 密钥 必需 类型 说明
To-do Id
 id True string

To-do Id

返回

Microsoft To-Do 对象。

Body
ToDo

获取 to-do 列表 [已弃用]

操作 ID:
GetToDoList

此作已弃用。 请改用“获取 to-do 列表”（V2）。

此作用于获取特定 to-do 列表。

参数

名称 密钥 必需 类型 说明
To-do List
 id True string

To-do 列表

返回

Microsoft To-Do 列表。

Body
TodoList

获取 to-do 列表 （V2）

操作 ID:
GetToDoListV2

此作用于获取特定 to-do 列表。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表

返回

Microsoft To-Do 列表。

Body
TodoList_V2

获取 to-do （V2） [已弃用]

操作 ID:
GetToDoV2

此作已弃用。 请改用“获取 to-do”（V3）。

此作用于获取具有给定 ID 的 to-do。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
待办事项任务
 id True string

待办事项任务

返回

Microsoft To-Do 对象。

Body
ToDo

获取 to-do（V3）

操作 ID:
GetToDoV3

此作用于获取具有给定 ID 的 to-do。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表
待办事项任务
 id True string

待办事项任务

返回

Microsoft To-Do 对象。

Body
ToDo_V2

触发器

创建新的 to-do 时 [已弃用]

创建新 to-do 时触发。
创建特定文件夹中的新 to-do 时 [已弃用]

此作已弃用。 请改用特定文件夹中的新 to-do（V2）。

创建特定文件夹中的新 to-do 时触发。
创建特定文件夹中的新 to-do 时（V2）

创建特定文件夹中的新 to-do 时触发。
更新 to-do 时 [已弃用]

更新 to-do 时触发。
更新特定文件夹中的 to-do 时 [已弃用]

此作已弃用。 请改用特定文件夹中的 to-do（V2）。

更新特定文件夹中的 to-do 时触发。
更新特定文件夹中的 to-do 时（V2）

更新特定文件夹中的 to-do 时触发。

创建新的 to-do 时 [已弃用]

操作 ID:
OnNewToDo

创建新 to-do 时触发。

返回

Microsoft To-Do 对象。

Body
ToDo

创建特定文件夹中的新 to-do 时 [已弃用]

操作 ID:
OnNewToDoInFolder

此作已弃用。 请改用特定文件夹中的新 to-do（V2）。

创建特定文件夹中的新 to-do 时触发。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表

返回

Microsoft To-Do 对象。

Body
ToDo

创建特定文件夹中的新 to-do 时（V2）

操作 ID:
OnNewToDoInFolderV2

创建特定文件夹中的新 to-do 时触发。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表

返回

Microsoft To-Do 对象。

Body
ToDo_V2

更新 to-do 时 [已弃用]

操作 ID:
OnUpdateToDo

更新 to-do 时触发。

返回

Microsoft To-Do 对象。

Body
ToDo

更新特定文件夹中的 to-do 时 [已弃用]

操作 ID:
OnUpdateToDoInFolder

此作已弃用。 请改用特定文件夹中的 to-do（V2）。

更新特定文件夹中的 to-do 时触发。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表

返回

Microsoft To-Do 对象。

Body
ToDo

更新特定文件夹中的 to-do 时（V2）

操作 ID:
OnUpdateToDoInFolderV2

更新特定文件夹中的 to-do 时触发。

参数

名称 密钥 必需 类型 说明
To-do List
 folderId True string

To-do 列表

返回

Microsoft To-Do 对象。

Body
ToDo_V2

定义

待办事项

Microsoft To-Do 对象。

名称 路径 类型 说明
Id
 id string

to-do的唯一标识符。
已创建 Date-Time
 createdDateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
修改后的 Date-Time
 lastModifiedDateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
类别
 categories array of string

与 to-do关联的类别名称的集合。
分配到
 assignedTo string

已分配 to-do的人员的姓名。
内容类型
 body.contentType string

Text=0，HTML=1
Content
 body.content string

文本或 HTML 内容。
日期时间
 completedDateTime.dateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
日期
 dueDateTime.dateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
重要性
 importance string

低、正常或高。
提醒
 isReminderOn boolean

如此 如果警报设置为提醒用户 to-do。
所有者
 owner string

创建 to-do的人员的名称。
父文件夹标识符
 parentFolderId string

父文件夹的唯一标识符。
日期时间
 reminderDateTime.dateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
日期
 startDateTime.dateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
状态
 status string

指示 to-do 的状态或进度 - 未启动、正在进行、已完成、等待他人或延迟。
Subject
 subject string

to-do的简要说明或标题。

ToDoHtml

Microsoft To-Do 对象。

名称 路径 类型 说明
Id
 id string

to-do的唯一标识符。
已创建 Date-Time
 createdDateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
修改后的 Date-Time
 lastModifiedDateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
类别
 categories array of string

与 to-do关联的类别名称的集合。
分配到
 assignedTo string

已分配 to-do的人员的姓名。
Content
 body.content html

内容。
日期时间
 completedDateTime.dateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
日期
 dueDateTime.dateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
重要性
 importance string

低、正常或高。
提醒
 isReminderOn boolean

如此 如果警报设置为提醒用户 to-do。
所有者
 owner string

创建 to-do的人员的名称。
父文件夹标识符
 parentFolderId string

父文件夹的唯一标识符。
日期时间
 reminderDateTime.dateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
日期
 startDateTime.dateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
状态
 status string

指示 to-do 的状态或进度 - 未启动、正在进行、已完成、等待他人或延迟。
Subject
 subject string

to-do的简要说明或标题。

TodoList

Microsoft To-Do 列表。

名称 路径 类型 说明
Id
 id string

to-do 列表的唯一标识符。
Name
 name string

to-do 列表的名称。
为默认值
 isDefaultFolder boolean

如此 如果这是默认 to-do 列表。

TodoList_V2

Microsoft To-Do 列表。

名称 路径 类型 说明
Id
 id string

to-do 列表的唯一标识符。
Name
 displayName string

to-do 列表的名称。
已知名称
 wellknownListName string

指示给定列表为已知列表时已知列表名称的属性。 可能的值包括：none、defaultList、flaggedEmails、unknownFutureValue。
是所有者
 isOwner boolean

如此 如果用户是给定任务列表的所有者。
共享
 isShared boolean

如此 如果任务列表与其他用户共享。

ToDo_V2

Microsoft To-Do 对象。

名称 路径 类型 说明
Id
 id string

to-do的唯一标识符。
已创建 Date-Time
 createdDateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
修改后的 Date-Time
 lastModifiedDateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
内容类型
 body.contentType string

内容的类型。 可能的值为文本和 html。
Content
 body.content string

项的内容。
修改后的 Date-Time
 bodyLastModifiedDateTime date-time

YYYY-MM-DDThh：mm：ssZ （UTC 格式）
日期
 completedDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss
日期
 dueDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss
重要性
 importance string

低、正常或高。
提醒
 isReminderOn boolean

如此 如果警报设置为提醒用户 to-do。
日期时间
 reminderDateTime.dateTime date-time

YYYY-MM-DDThh:mm:ss
状态
 status string

指示 to-do 的状态或进度 - 未启动、正在进行、已完成、等待他人或延迟。
Title
 title string

to-do的简要说明或标题。