共用方式為

Microsoft To-Do（消費者）

Microsoft To-Do 是一款智能任務管理應用程序，可讓您輕鬆計劃和管理您的一天。 連接到Microsoft To-Do 以管理來自各種服務的任務。 您可以執行建立任務等動作。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 標準 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 標準 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 標準 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher Microsoft
網站 https://todo.microsoft.com/tasks/

已知問題和限制

To Do API 具有大部分的 Outlook 工作 功能。 請注意， outlookTaskGroup 實體、擴充屬性和 assignedTo、outlookTask 實體 的擁有者屬性在待辦事項 API 中無法使用。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒
觸發輪詢的頻率 1 120 秒

動作

列出所有 to-do 清單

傳回所有 to-do 清單的清單。
刪除 to-do

此作業可用來刪除工作。
刪除 to-do 清單

此作業可用來刪除特定 to-do 清單。
取得 to-do 清單

此作業可用來取得特定的 to-do 清單。
建立 to-do 清單

此作業可用來建立新的 to-do 清單。
按文件夾列出 to-do

此作業可用來從特定清單擷取所有 to-do。
新增 to-do

此作業可用來在指定的 to-do 清單中建立 to-do。
更新 to-do

此作業可用來更新特定 to-do。
更新 to-do 清單

此作業可用來更新特定的 to-do 清單。
獲取 to-do

此作業可用來取得具有指定 ID 的 to-do。

列出所有 to-do 清單

作業識別碼：
GetAllTodoLists

傳回所有 to-do 清單的清單。

傳回

response
array of TodoList

刪除 to-do

作業識別碼：
DeleteToDo

此作業可用來刪除工作。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單
待辦事項
 id True string

待辦事項

刪除 to-do 清單

作業識別碼：
DeleteToDoList

此作業可用來刪除特定 to-do 清單。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單

取得 to-do 清單

作業識別碼：
GetToDoList

此作業可用來取得特定的 to-do 清單。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單

傳回

Microsoft To-Do 清單。

身體
TodoList

建立 to-do 清單

作業識別碼：
CreateToDoList

此作業可用來建立新的 to-do 清單。

參數

名稱 機碼 必要 類型 Description
名稱
 displayName True string

清單名稱

傳回

Microsoft To-Do 清單。

身體
TodoList

按文件夾列出 to-do

作業識別碼：
ListToDosByFolder

此作業可用來從特定清單擷取所有 to-do。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單
最高計數
 $top integer

要擷取的項目總數 （預設值 = 10，最大值 = 999）。

傳回

response
array of ToDo

新增 to-do

作業識別碼：
CreateToDo

此作業可用來在指定的 to-do 清單中建立 to-do。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單
到期日
 dateTime date-time

YYYY-MM-DDhh：mm：ss
溫馨提示 Date-Time
 dateTime date-time

YYYY-MM-DDhh：mm：ss
重要性
 importance string

低、正常或高。
Title
 title True string

to-do的簡要描述或標題。
地位
 status string

指出 to-do 的狀態或進度 - 未啟動、進行中、已完成、等待其他人或延遲。
Content
 content html

項目的內容。
提醒是否開啟
 isReminderOn boolean

如果警示設定為提醒使用者 to-do，則為 True。

傳回

Microsoft To-Do 物件。

身體
ToDo

更新 to-do

作業識別碼：
UpdateToDo

此作業可用來更新特定 to-do。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單
待辦事項
 id True string

待辦事項
到期日
 dateTime date-time

YYYY-MM-DDhh：mm：ss
溫馨提示 Date-Time
 dateTime date-time

YYYY-MM-DDhh：mm：ss
重要性
 importance string

低、正常或高。
Title
 title string

to-do的簡要描述或標題。
地位
 status string

指出 to-do 的狀態或進度 - 未啟動、進行中、已完成、等待其他人或延遲。
Content
 content html

項目的內容。
提醒是否開啟
 isReminderOn boolean

如果警示設定為提醒使用者 to-do，則為 True。

傳回

Microsoft To-Do 物件。

身體
ToDo

更新 to-do 清單

作業識別碼：
UpdateToDoList

此作業可用來更新特定的 to-do 清單。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單
名稱
 displayName True string

清單名稱

傳回

Microsoft To-Do 清單。

身體
TodoList

獲取 to-do

作業識別碼：
GetToDo

此作業可用來取得具有指定 ID 的 to-do。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單
待辦事項
 id True string

待辦事項

傳回

Microsoft To-Do 物件。

身體
ToDo

觸發程序

在特定資料夾中建立新 to-do 時

在建立特定資料夾中的新 to-do 時觸發。
更新特定資料夾中的 to-do 時

當更新特定資料夾中的 to-do 時觸發。

在特定資料夾中建立新 to-do 時

作業識別碼：
OnNewToDoInFolder

在建立特定資料夾中的新 to-do 時觸發。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單

傳回

Microsoft To-Do 物件。

身體
ToDo

更新特定資料夾中的 to-do 時

作業識別碼：
OnUpdateToDoInFolder

當更新特定資料夾中的 to-do 時觸發。

參數

名稱 機碼 必要 類型 Description
待辦事項清單
 folderId True string

待辦事項清單

傳回

Microsoft To-Do 物件。

身體
ToDo

定義

待辦事項清單

Microsoft To-Do 清單。

名稱 路徑 類型 Description
Id
 id string

to-do 清單的唯一識別碼。
名稱
 displayName string

to-do 清單的名稱。
眾所周知的名字
 wellknownListName string

如果指定的清單是已知清單，則指出已知清單名稱的屬性。 可能的值為：none、defaultList、flaggedEmails、unknownFutureValue。
是所有者
 isOwner boolean

如果使用者是指定工作清單的擁有者，則為 True。
是共享的
 isShared boolean

如果工作清單與其他使用者共用，則為 True。

待辦事項

Microsoft To-Do 物件。

名稱 路徑 類型 Description
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

內容的型別。 可能的值為 text 和 html。
Content
 body.content string

項目的內容。
修改後的 Date-Time
 bodyLastModifiedDateTime date-time

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

YYYY-MM-DDhh：mm：ss
Date
 dueDateTime.dateTime date-time

YYYY-MM-DDhh：mm：ss
重要性
 importance string

低、正常或高。
提醒是否開啟
 isReminderOn boolean

如果警示設定為提醒使用者 to-do，則為 True。
Date-Time
 reminderDateTime.dateTime date-time

YYYY-MM-DDhh：mm：ss
地位
 status string

指出 to-do 的狀態或進度 - 未啟動、進行中、已完成、等待其他人或延遲。
Title
 title string

to-do的簡要描述或標題。