規劃者
Microsoft Planner 可讓您輕鬆地將團隊、任務、文檔和對話聚集在一起，以獲得更好的結果。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure 中國區域 |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 由 21Vianet 營運的中國雲 |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://planner.cloud.microsoft |
如需詳細資訊，請參閱 Planner API 文件
已知問題和限制
這很重要
Planner 連接器目前僅支援基本方案。
請注意，某些動作和觸發器需要您提供 Group Id，但這僅用於填入其他相依下拉式清單（例如， 建立任務 動作會 Plan Id 根據提供的 Group Id填入下拉式清單）。 填入相依下拉式清單之後，任何值都可以插入欄位中 Group Id ，而且即使連接器可能會向您提供有關欄位 Group Id 的任何警告，動作仍會如預期般運作。
以下是上述適用的動作/觸發器的完整清單：
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
| 觸發輪詢的頻率 | 1 | 60 秒 |
動作
| 列出值區 |
列出計劃中的儲存貯體。 |
| 列出工作 |
列出計劃中的任務。 |
| 列出工作 [已棄用] |
此動作已被取代。 請改用 列出 工作 。
|
| 列出工作 [已棄用] |
此動作已被取代。 請改用 列出 工作 。
|
| 列出我的任務 |
列出指派給我的任務。 |
| 列出我的工作 [已棄用] |
此動作已被取代。 請改用 列出我的任務 。
|
| 列出我的計劃 [已棄用] |
列出使用者已訂閱的方案。 |
| 列出我的計劃 [已棄用] |
列出使用者已訂閱的方案。 |
| 列出群組的計劃 |
列出指定群組所擁有的計劃。 |
| 刪除工作 （預覽版） |
刪除現有的 Planner 任務。 |
| 取得任務 |
取得現有的 Planner 工作。 |
| 取得工作 [已棄用] |
此動作已被取代。 請改用 取得工作 。
|
| 取得工作詳細資料 |
取得現有任務的任務詳細資料。 |
| 取得工作詳細資料 [已淘汰] |
此動作已被取代。 請改用 [取得任務詳細資料 ]。
|
| 取得方案詳細資料 （預覽版） |
取得任務所屬的計劃詳細資料 |
| 將受指派人新增至任務 |
將受指派人新增至現有的 Planner 任務。 |
| 建立任務 |
在 Planner 中建立新任務。 |
| 建立儲存貯體 |
在 Planner 中為指定的計劃和群組建立儲存區。 |
| 建立儲存貯體 [已棄用] |
此動作已被取代。 請改用 建立儲存貯體 。
|
| 建立工作 [已棄用] |
此動作已被取代。 請改用 建立工作 。
|
| 建立工作 [已棄用] |
此動作已被取代。 請改用 建立工作 。
|
| 建立工作 （預覽版） |
在 Planner 中建立新任務。 |
| 從任務中移除受指派人 |
從現有的Planner任務中移除受指派人。 |
| 更新任務詳細資料 |
更新現有任務的任務詳細資料。 |
| 更新工作 |
更新現有的 Planner 任務。 |
| 更新工作 [已棄用] |
此動作已被取代。 請改用更新工作 （V2）。
|
| 更新工作 （V2） （預覽版） |
更新現有的 Planner 任務。 |
| 更新工作詳細資料 [已棄用] |
此動作已被取代。 請改用 更新工作詳細資料 。
|
| 清單儲存貯體 [已棄用] |
此動作已被取代。 請改用 List buckets 。
|
| 清單儲存貯體 [已棄用] |
此動作已被取代。 請改用 List buckets 。
|
列出值區
列出計劃中的儲存貯體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組識別碼
|
groupId | True | string |
要擷取計劃的群組。 |
|
方案標識碼
|
id | True | string |
計劃的唯一識別碼。 |
傳回
列出工作
列出計劃中的任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組識別碼
|
groupId | True | string |
要擷取計劃的群組。 |
|
方案標識碼
|
id | True | string |
計劃的唯一識別碼。 |
傳回
列出工作 [已棄用]
列出工作 [已棄用]
列出我的任務
列出我的工作 [已棄用]
列出我的計劃 [已棄用]
列出我的計劃 [已棄用]
列出群組的計劃
列出指定群組所擁有的計劃。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組識別碼
|
groupId | True | string |
群組的識別碼。 |
傳回
刪除工作 （預覽版）
刪除現有的 Planner 任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要刪除之工作的唯一識別碼。 |
取得任務
取得現有的 Planner 工作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要更新之工作的唯一識別碼。 |
傳回
取得工作 [已棄用]
取得工作詳細資料
取得現有任務的任務詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要更新之工作的唯一識別碼。 |
傳回
取得工作詳細資料 [已淘汰]
此動作已被取代。 請改用 [取得任務詳細資料 ]。
取得現有任務的任務詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
任務的唯一識別碼。 |
傳回
取得方案詳細資料 （預覽版）
取得任務所屬的計劃詳細資料
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
id | True | string |
唯一的計劃識別碼。 |
傳回
將受指派人新增至任務
將受指派人新增至現有的 Planner 任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要更新之工作的唯一識別碼。 |
|
指派的使用者識別碼
|
assignments | True | string |
應指派給此工作的使用者的分號分隔識別碼或電子郵件地址。 |
傳回
建立任務
在 Planner 中建立新任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組識別碼
|
groupId | True | string |
要擷取計劃的群組。 |
|
方案標識碼
|
planId | True | string |
新任務的計劃。 |
|
Title
|
title | True | string |
新任務的標題（最多 255 個字元）。 |
|
儲存貯體識別碼
|
bucketId | string |
要放置此任務的儲存貯體。 |
|
|
開始日期時間
|
startDateTime | date-time |
工作開始的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
到期日時間
|
dueDateTime | date-time |
工作到期的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
指派的使用者識別碼
|
assignments | string |
要指派此工作的使用者的分號分隔 ID 或電子郵件地址。 |
|
|
粉紅色
|
category1 | boolean |
如果任務具有「粉紅色」類別，則為 True。 |
|
|
Red
|
category2 | boolean |
如果任務具有紅色類別，則為 True。 |
|
|
Yellow
|
category3 | boolean |
如果任務具有黃色類別，則為 True。 |
|
|
Green
|
category4 | boolean |
如果任務具有綠色類別，則為 True。 |
|
|
Blue
|
category5 | boolean |
如果任務具有藍色類別，則為 True。 |
|
|
Purple
|
category6 | boolean |
如果任務具有紫色類別，則為 True。 |
|
|
青銅
|
category7 | boolean |
如果任務具有「青銅」類別，則為 true。 |
|
|
石灰
|
category8 | boolean |
如果任務具有 Lime 類別，則為 True。 |
|
|
Aqua
|
category9 | boolean |
如果任務具有 Aqua 類別，則為 True。 |
|
|
Gray
|
category10 | boolean |
如果任務具有灰色類別，則為 True。 |
|
|
銀色
|
category11 | boolean |
如果任務具有 Silver 類別，則為 True。 |
|
|
棕色
|
category12 | boolean |
如果任務具有棕色類別，則為 True。 |
|
|
蔓越莓
|
category13 | boolean |
如果任務具有蔓越莓類別，則為 True。 |
|
|
橙
|
category14 | boolean |
如果任務具有 [橘色] 類別，則為 True。 |
|
|
桃
|
category15 | boolean |
如果任務具有 Peach 類別，則為 True。 |
|
|
萬壽菊
|
category16 | boolean |
如果任務具有 Marigold 類別，則為 True。 |
|
|
䵮
|
category17 | boolean |
如果任務具有淺綠色類別，則為 True。 |
|
|
深綠色
|
category18 | boolean |
如果任務具有深綠色類別，則為 True。 |
|
|
藍綠色
|
category19 | boolean |
如果任務具有 Teal 類別，則為 True。 |
|
|
䵮
|
category20 | boolean |
如果任務具有淺藍色類別，則為 True。 |
|
|
深藍色
|
category21 | boolean |
如果任務具有深藍色類別，則為 True。 |
|
|
薰衣草
|
category22 | boolean |
如果任務具有 Lavender 類別，則為 True。 |
|
|
李子
|
category23 | boolean |
如果工作具有 Plum 類別，則為 True。 |
|
|
淺灰色
|
category24 | boolean |
如果任務具有淺灰色類別，則為 True。 |
|
|
深灰色
|
category25 | boolean |
如果任務具有深灰色類別，則為 True。 |
傳回
建立儲存貯體
在 Planner 中為指定的計劃和群組建立儲存區。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
儲存貯體的名稱 |
|
群組識別碼
|
groupId | True | string |
要擷取計劃的群組。 |
|
方案標識碼
|
planId | True | string |
新儲存區的計劃。 |
傳回
建立儲存貯體 [已棄用]
此動作已被取代。 請改用 建立儲存貯體 。
在 Planner 中建立儲存貯體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
儲存貯體的名稱 |
|
方案標識碼
|
planId | True | string |
新儲存貯體的計劃 |
傳回
建立工作 [已棄用]
此動作已被取代。 請改用 建立工作 。
在 Planner 中建立新任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
planId | True | string |
新任務的計劃。 |
|
Title
|
title | True | string |
新任務的標題。 |
|
儲存貯體識別碼
|
bucketId | string |
要放置此任務的儲存貯體。 |
|
|
開始日期時間
|
startDateTime | date-time |
工作開始的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
到期日時間
|
dueDateTime | date-time |
工作到期的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
指派的使用者識別碼
|
assignments | string |
要指派此工作的使用者的分號分隔 ID 或電子郵件地址。 |
傳回
建立工作 [已棄用]
此動作已被取代。 請改用 建立工作 。
在 Planner 中建立新任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
planId | True | string |
新任務的計劃。 |
|
Title
|
title | True | string |
新任務的標題。 |
|
儲存貯體識別碼
|
bucketId | string |
要放置此任務的儲存貯體。 |
|
|
開始日期時間
|
startDateTime | date-time |
工作開始的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
到期日時間
|
dueDateTime | date-time |
工作到期的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
指派的使用者 ID
|
assignments | string |
要指派此工作的使用者的 ID 或電子郵件地址。 |
傳回
建立工作 （預覽版）
在 Planner 中建立新任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組識別碼
|
groupId | True | string |
要擷取計劃的群組。 |
|
方案標識碼
|
planId | True | string |
新任務的計劃。 |
|
Title
|
title | True | string |
新任務的標題（最多 255 個字元）。 |
|
儲存貯體識別碼
|
bucketId | string |
要放置此任務的儲存貯體。 |
|
|
開始日期時間
|
startDateTime | date-time |
工作開始的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
到期日時間
|
dueDateTime | date-time |
工作到期的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
指派的使用者識別碼
|
assignments | string |
要指派此工作的使用者的分號分隔 ID 或電子郵件地址。 |
|
|
粉紅色
|
category1 | boolean |
如果任務具有「粉紅色」類別，則為 True。 |
|
|
Red
|
category2 | boolean |
如果任務具有紅色類別，則為 True。 |
|
|
Yellow
|
category3 | boolean |
如果任務具有黃色類別，則為 True。 |
|
|
Green
|
category4 | boolean |
如果任務具有綠色類別，則為 True。 |
|
|
Blue
|
category5 | boolean |
如果任務具有藍色類別，則為 True。 |
|
|
Purple
|
category6 | boolean |
如果任務具有紫色類別，則為 True。 |
|
|
青銅
|
category7 | boolean |
如果任務具有「青銅」類別，則為 true。 |
|
|
石灰
|
category8 | boolean |
如果任務具有 Lime 類別，則為 True。 |
|
|
Aqua
|
category9 | boolean |
如果任務具有 Aqua 類別，則為 True。 |
|
|
Gray
|
category10 | boolean |
如果任務具有灰色類別，則為 True。 |
|
|
銀色
|
category11 | boolean |
如果任務具有 Silver 類別，則為 True。 |
|
|
棕色
|
category12 | boolean |
如果任務具有棕色類別，則為 True。 |
|
|
蔓越莓
|
category13 | boolean |
如果任務具有蔓越莓類別，則為 True。 |
|
|
橙
|
category14 | boolean |
如果任務具有 [橘色] 類別，則為 True。 |
|
|
桃
|
category15 | boolean |
如果任務具有 Peach 類別，則為 True。 |
|
|
萬壽菊
|
category16 | boolean |
如果任務具有 Marigold 類別，則為 True。 |
|
|
䵮
|
category17 | boolean |
如果任務具有淺綠色類別，則為 True。 |
|
|
深綠色
|
category18 | boolean |
如果任務具有深綠色類別，則為 True。 |
|
|
藍綠色
|
category19 | boolean |
如果任務具有 Teal 類別，則為 True。 |
|
|
䵮
|
category20 | boolean |
如果任務具有淺藍色類別，則為 True。 |
|
|
深藍色
|
category21 | boolean |
如果任務具有深藍色類別，則為 True。 |
|
|
薰衣草
|
category22 | boolean |
如果任務具有 Lavender 類別，則為 True。 |
|
|
李子
|
category23 | boolean |
如果工作具有 Plum 類別，則為 True。 |
|
|
淺灰色
|
category24 | boolean |
如果任務具有淺灰色類別，則為 True。 |
|
|
深灰色
|
category25 | boolean |
如果任務具有深灰色類別，則為 True。 |
|
|
Priority
|
priority | integer |
任務的優先順序。 有效的值範圍介於 0 到 10 （含） 之間，遞增值的優先順序較低 （0 具有最高優先順序，10 具有最低優先順序）。 目前，Planner 將值 0 和 1 解譯為「緊急」，將 2 和 3 以及 4 解譯為「重要」，將 5、6 和 7 解譯為「中」，將 8、9 和 10 解譯為「低」。 目前，Planner 將值 1 設定為「緊急」，3 設定為「重要」，5 設定為「中」，9 設定為「低」。 |
傳回
從任務中移除受指派人
從現有的Planner任務中移除受指派人。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要更新之工作的唯一識別碼。 |
|
移除指派的使用者
|
assignments | True | string |
應取消指派給此工作的使用者的分號分隔識別碼或電子郵件地址。 |
傳回
更新任務詳細資料
更新現有任務的任務詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要更新之工作的唯一識別碼。 |
|
Description
|
description | string |
工作的描述。 |
|
|
Alias
|
alias | string |
描述參照的名稱別名。 |
|
|
資源連結
|
resourceLink | True | uri |
以 HTTP/HTTPS 通訊協定為基礎的有效 URL。 |
|
參考的類型
|
type |
用來描述參照的類型。 |
||
|
Id
|
id | True | string |
代表檢查清單項目的數字。 |
|
Title
|
title | True | string |
檢查清單項目的名稱。 |
|
已核中
|
isChecked | True | boolean |
是否檢查項目。 |
傳回
更新工作
更新現有的 Planner 任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要更新之工作的唯一識別碼。 |
|
Title
|
title | string |
計劃的標題。 |
|
|
應 Date-Time
|
dueDateTime | date-time |
工作到期的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
開始 Date-Time
|
startDateTime | date-time |
工作開始的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
Progress
|
percentComplete | string |
任務的進度。 |
|
|
新增指派的使用者
|
assignments | string |
應指派給此工作的使用者的分號分隔識別碼或電子郵件地址。 |
|
|
移除指派的使用者
|
unassignedUsers | string |
應從此工作中取消指派的使用者的分號分隔 ID 或電子郵件地址。 |
傳回
更新工作 [已棄用]
此動作已被取代。 請改用更新工作 （V2）。
更新現有的 Planner 任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要更新的 tast 的唯一識別碼。 |
|
Title
|
title | string |
計劃的標題。 |
|
|
應 Date-Time
|
dueDateTime | date-time |
工作到期的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
開始 Date-Time
|
startDateTime | date-time |
工作開始的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
Progress
|
percentComplete | string |
任務的進度。 |
|
|
已輔助的使用者 ID
|
assignments | string |
要指派此工作的使用者的 ID 或電子郵件地址。 |
傳回
更新工作 （V2） （預覽版）
更新現有的 Planner 任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
要更新之工作的唯一識別碼。 |
|
Title
|
title | string |
計劃的標題 （最多 255 個字元）。 |
|
|
應 Date-Time
|
dueDateTime | date-time |
工作到期的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
開始 Date-Time
|
startDateTime | date-time |
工作開始的日期時間 （例如 '2018-04-13T00：42：19.284Z'）。 |
|
|
完成百分比
|
percentComplete | integer |
任務的完成百分比。 |
|
|
儲存貯體識別碼
|
bucketId | string |
要放置此任務的儲存貯體。 |
|
|
粉紅色
|
category1 | boolean |
如果任務具有「粉紅色」類別，則為 True。 |
|
|
Red
|
category2 | boolean |
如果任務具有紅色類別，則為 True。 |
|
|
Yellow
|
category3 | boolean |
如果任務具有黃色類別，則為 True。 |
|
|
Green
|
category4 | boolean |
如果任務具有綠色類別，則為 True。 |
|
|
Blue
|
category5 | boolean |
如果任務具有藍色類別，則為 True。 |
|
|
Purple
|
category6 | boolean |
如果任務具有紫色類別，則為 True。 |
|
|
青銅
|
category7 | boolean |
如果任務具有「青銅」類別，則為 true。 |
|
|
石灰
|
category8 | boolean |
如果任務具有 Lime 類別，則為 True。 |
|
|
Aqua
|
category9 | boolean |
如果任務具有 Aqua 類別，則為 True。 |
|
|
Gray
|
category10 | boolean |
如果任務具有灰色類別，則為 True。 |
|
|
銀色
|
category11 | boolean |
如果任務具有 Silver 類別，則為 True。 |
|
|
棕色
|
category12 | boolean |
如果任務具有棕色類別，則為 True。 |
|
|
蔓越莓
|
category13 | boolean |
如果任務具有蔓越莓類別，則為 True。 |
|
|
橙
|
category14 | boolean |
如果任務具有 [橘色] 類別，則為 True。 |
|
|
桃
|
category15 | boolean |
如果任務具有 Peach 類別，則為 True。 |
|
|
萬壽菊
|
category16 | boolean |
如果任務具有 Marigold 類別，則為 True。 |
|
|
䵮
|
category17 | boolean |
如果任務具有淺綠色類別，則為 True。 |
|
|
深綠色
|
category18 | boolean |
如果任務具有深綠色類別，則為 True。 |
|
|
藍綠色
|
category19 | boolean |
如果任務具有 Teal 類別，則為 True。 |
|
|
䵮
|
category20 | boolean |
如果任務具有淺藍色類別，則為 True。 |
|
|
深藍色
|
category21 | boolean |
如果任務具有深藍色類別，則為 True。 |
|
|
薰衣草
|
category22 | boolean |
如果任務具有 Lavender 類別，則為 True。 |
|
|
李子
|
category23 | boolean |
如果工作具有 Plum 類別，則為 True。 |
|
|
淺灰色
|
category24 | boolean |
如果任務具有淺灰色類別，則為 True。 |
|
|
深灰色
|
category25 | boolean |
如果任務具有深灰色類別，則為 True。 |
傳回
更新工作詳細資料 [已棄用]
此動作已被取代。 請改用 更新工作詳細資料 。
更新現有任務的任務詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
任務標識符
|
id | True | string |
任務的唯一識別碼。 |
|
Description
|
description | string |
工作的描述。 |
|
|
Alias
|
alias | string |
描述參照的名稱別名。 |
|
|
資源連結
|
resourceLink | True | uri |
以 HTTP/HTTPS 通訊協定為基礎的有效 URL。 |
|
參考的類型
|
type |
用來描述參照的類型。 |
||
|
Id
|
id | True | string |
代表檢查清單項目的數字。 |
|
Title
|
title | True | string |
檢查清單項目的名稱。 |
|
已核中
|
isChecked | True | boolean |
是否檢查項目。 |
傳回
清單儲存貯體 [已棄用]
此動作已被取代。 請改用 List buckets 。
列出計劃中的儲存貯體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
id | True | string |
計劃的唯一識別碼。 |
傳回
清單儲存貯體 [已棄用]
此動作已被取代。 請改用 List buckets 。
列出計劃中的儲存貯體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
id | True | string |
計劃的唯一識別碼。 |
傳回
觸發程序
| 建立新任務時 |
此作業會在建立新工作時觸發。 |
| 建立新工作時 [已棄用] |
此動作已被取代。 請改用建立 新任務時 。
|
| 建立新工作時 [已棄用] |
此動作已被取代。 請改用建立 新任務時 。
|
| 指派給我工作時 [已棄用] |
此動作已被取代。 請改用 當 任務指派給我時 。
|
| 指派給我的任務時 |
當任務分配給我時，會觸發此操作。 |
| 當任務完成時 |
此作業會在任務完成時觸發。 |
| 當任務完成時 [已淘汰] |
此動作已被取代。 請改用 When a task is done 。
|
| 當任務完成時 [已淘汰] |
此動作已被取代。 請改用 When a task is done 。
|
建立新任務時
此作業會在建立新工作時觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組識別碼
|
groupId | True | string |
要擷取計劃的群組。 |
|
方案標識碼
|
id | True | string |
計劃的唯一識別碼。 |
傳回
建立新工作時 [已棄用]
建立新工作時 [已棄用]
指派給我工作時 [已棄用]
指派給我的任務時
當任務完成時
此作業會在任務完成時觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組識別碼
|
groupId | True | string |
要擷取計劃的群組。 |
|
方案標識碼
|
id | True | string |
計劃的唯一識別碼。 |
傳回
當任務完成時 [已淘汰]
此動作已被取代。 請改用 When a task is done 。
此作業會在任務完成時觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
id | True | string |
計劃的唯一識別碼。 |
傳回
當任務完成時 [已淘汰]
此動作已被取代。 請改用 When a task is done 。
此作業會在任務完成時觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
id | True | string |
計劃的唯一識別碼。 |
傳回
定義
ListBuckets_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of object | |
|
名稱
|
value.name | string |
儲存貯體的名稱。 |
|
方案標識碼
|
value.planId | string |
此儲存貯體所屬計畫的 ID。 |
|
Id
|
value.id | string |
儲存貯體的 ID。 |
ListMyPlans_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of object | |
|
Title
|
value.title | string |
計劃的標題。 |
|
Id
|
value.id | string |
計劃的 ID。 |
GetTaskDetails_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Description
|
description | string |
工作的描述。 |
|
Id
|
id | string |
任務的 ID。 |
|
參考資料
|
references | array of object |
任務上的參考集合 |
|
資源連結
|
references.resourceLink | uri |
以 HTTP/HTTPS 通訊協定為基礎的有效 URL。 |
|
Alias
|
references.value.alias | string |
描述參照的名稱別名。 |
|
參考的類型
|
references.value.type |
用來描述參照的類型。 |
|
|
Checklist
|
checklist | array of object |
任務上的檢查清單項目集合。 |
|
Id
|
checklist.id | string |
代表檢查清單項目的數字。 |
|
Title
|
checklist.value.title | string |
檢查清單項目的名稱。 |
|
已核中
|
checklist.value.isChecked | boolean |
是否檢查項目。 |
CreateBucket_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
name | string |
儲存貯體的名稱 |
|
方案標識碼
|
planId | string |
儲存貯體所屬的計劃 ID |
|
訂單提示
|
orderHint | string |
用於在清單檢視中排序此類型項目的提示 |
|
Id
|
id | string |
儲存貯體的ID |
GetTask_Response_V2
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顯示名稱
|
createdBy.user.displayName | string |
建立此工作的使用者的顯示名稱。 |
|
Id
|
createdBy.user.id | string |
建立此工作的使用者的識別碼。 |
|
方案標識碼
|
planId | string |
此工作所屬計劃的 ID。 |
|
儲存貯體識別碼
|
bucketId | string |
此任務所屬儲存貯體的 ID。 |
|
Title
|
title | string |
工作的標題。 |
|
完成百分比
|
percentComplete | integer |
任務的完成百分比。 |
|
開始日期時間
|
startDateTime | date-time |
任務的開始日期時間。 |
|
建立日期時間
|
createdDateTime | date-time |
建立任務的日期時間。 |
|
到期日時間
|
dueDateTime | date-time |
任務到期的日期時間。 |
|
有描述
|
hasDescription | boolean |
如果任務有描述，則設為 true。 |
|
完成日期時間
|
completedDateTime | date-time |
任務完成的日期時間。 |
|
參考計數
|
referenceCount | integer |
任務上存在的外部參照數目。 |
|
Id
|
id | string |
任務的 ID。 |
|
應用類別
|
appliedCategories | AppliedCategories |
已套用任務的類別。 |
|
assignments
|
_assignments | array of object | |
|
指派給使用者 ID
|
_assignments.userId | string |
指派此工作的使用者識別碼。 |
|
依使用者識別碼指派
|
_assignments.value.assignedBy.user.id | string |
指派此工作的使用者識別碼。 |
|
指派的日期時間
|
_assignments.value.assignedDateTime | date-time |
指派任務的日期時間。 |
|
訂單提示
|
_assignments.value.orderHint | string |
訂單提示 |
GetTask_Response_V3
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顯示名稱
|
createdBy.user.displayName | string |
建立此工作的使用者的顯示名稱。 |
|
Id
|
createdBy.user.id | string |
建立此工作的使用者的識別碼。 |
|
方案標識碼
|
planId | string |
此工作所屬計劃的 ID。 |
|
儲存貯體識別碼
|
bucketId | string |
此任務所屬儲存貯體的 ID。 |
|
Title
|
title | string |
工作的標題。 |
|
完成百分比
|
percentComplete | integer |
任務的完成百分比。 |
|
開始日期時間
|
startDateTime | date-time |
任務的開始日期時間。 |
|
建立日期時間
|
createdDateTime | date-time |
建立任務的日期時間。 |
|
到期日時間
|
dueDateTime | date-time |
任務到期的日期時間。 |
|
有描述
|
hasDescription | boolean |
如果任務有描述，則設為 true。 |
|
完成日期時間
|
completedDateTime | date-time |
任務完成的日期時間。 |
|
參考計數
|
referenceCount | integer |
任務上存在的外部參照數目。 |
|
Id
|
id | string |
任務的 ID。 |
|
應用類別
|
appliedCategories | AppliedCategories |
已套用任務的類別。 |
|
Priority
|
priority | integer |
任務的優先順序。 有效的值範圍介於 0 到 10 （含） 之間，遞增值的優先順序較低 （0 具有最高優先順序，10 具有最低優先順序）。 目前，Planner 將值 0 和 1 解譯為「緊急」，將 2 和 3 以及 4 解譯為「重要」，將 5、6 和 7 解譯為「中」，將 8、9 和 10 解譯為「低」。 目前，Planner 將值 1 設定為「緊急」，3 設定為「重要」，5 設定為「中」，9 設定為「低」。 |
|
assignments
|
_assignments | array of object | |
|
指派給使用者 ID
|
_assignments.userId | string |
指派此工作的使用者識別碼。 |
|
依使用者識別碼指派
|
_assignments.value.assignedBy.user.id | string |
指派此工作的使用者識別碼。 |
|
指派的日期時間
|
_assignments.value.assignedDateTime | date-time |
指派任務的日期時間。 |
|
訂單提示
|
_assignments.value.orderHint | string |
訂單提示 |
ListTasks_Response_V2
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of GetTask_Response_V2 |
應用類別
已套用任務的類別。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
粉紅色
|
category1 | boolean |
如果任務具有「粉紅色」類別，則為 True。 |
|
Red
|
category2 | boolean |
如果任務具有紅色類別，則為 True。 |
|
Yellow
|
category3 | boolean |
如果任務具有黃色類別，則為 True。 |
|
Green
|
category4 | boolean |
如果任務具有綠色類別，則為 True。 |
|
Blue
|
category5 | boolean |
如果任務具有藍色類別，則為 True。 |
|
Purple
|
category6 | boolean |
如果任務具有紫色類別，則為 True。 |
|
青銅
|
category7 | boolean |
如果任務具有「青銅」類別，則為 true。 |
|
石灰
|
category8 | boolean |
如果任務具有 Lime 類別，則為 True。 |
|
Aqua
|
category9 | boolean |
如果任務具有 Aqua 類別，則為 True。 |
|
Gray
|
category10 | boolean |
如果任務具有灰色類別，則為 True。 |
|
銀色
|
category11 | boolean |
如果任務具有 Silver 類別，則為 True。 |
|
棕色
|
category12 | boolean |
如果任務具有棕色類別，則為 True。 |
|
蔓越莓
|
category13 | boolean |
如果任務具有蔓越莓類別，則為 True。 |
|
橙
|
category14 | boolean |
如果任務具有 [橘色] 類別，則為 True。 |
|
桃
|
category15 | boolean |
如果任務具有 Peach 類別，則為 True。 |
|
萬壽菊
|
category16 | boolean |
如果任務具有 Marigold 類別，則為 True。 |
|
䵮
|
category17 | boolean |
如果任務具有淺綠色類別，則為 True。 |
|
深綠色
|
category18 | boolean |
如果任務具有深綠色類別，則為 True。 |
|
藍綠色
|
category19 | boolean |
如果任務具有 Teal 類別，則為 True。 |
|
䵮
|
category20 | boolean |
如果任務具有淺藍色類別，則為 True。 |
|
深藍色
|
category21 | boolean |
如果任務具有深藍色類別，則為 True。 |
|
薰衣草
|
category22 | boolean |
如果任務具有 Lavender 類別，則為 True。 |
|
李子
|
category23 | boolean |
如果工作具有 Plum 類別，則為 True。 |
|
淺灰色
|
category24 | boolean |
如果任務具有淺灰色類別，則為 True。 |
|
深灰色
|
category25 | boolean |
如果任務具有深灰色類別，則為 True。 |
GetTask_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顯示名稱
|
createdBy.user.displayName | string |
建立此工作的使用者的顯示名稱。 |
|
Id
|
createdBy.user.id | string |
建立此工作的使用者的識別碼。 |
|
方案標識碼
|
planId | string |
此工作所屬計劃的 ID。 |
|
儲存貯體識別碼
|
bucketId | string |
此任務所屬儲存貯體的 ID。 |
|
Title
|
title | string |
工作的標題。 |
|
完成百分比
|
percentComplete | integer |
任務的完成百分比。 |
|
開始日期時間
|
startDateTime | date-time |
任務的開始日期時間。 |
|
建立日期時間
|
createdDateTime | date-time |
建立任務的日期時間。 |
|
到期日時間
|
dueDateTime | date-time |
任務到期的日期時間。 |
|
有描述
|
hasDescription | boolean |
如果任務有描述，則設為 true。 |
|
完成日期時間
|
completedDateTime | date-time |
任務完成的日期時間。 |
|
參考計數
|
referenceCount | integer |
任務上存在的外部參照數目。 |
|
Id
|
id | string |
任務的 ID。 |
ListTasks_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of object | |
|
依顯示名稱建立
|
value.createdBy.user.displayName | string |
建立此工作的使用者的顯示名稱。 |
|
Id
|
value.createdBy.user.id | string |
建立此工作的使用者的識別碼。 |
|
依顯示名稱完成
|
value.completedBy.user.displayName | string |
顯示名稱 |
|
識別碼
|
value.completedBy.user.id | string |
識別碼 |
|
方案標識碼
|
value.planId | string |
此工作所屬計劃的 ID。 |
|
儲存貯體識別碼
|
value.bucketId | string |
此任務所屬儲存貯體的 ID。 |
|
Title
|
value.title | string |
工作的標題。 |
|
完成百分比
|
value.percentComplete | integer |
任務的完成百分比。 |
|
開始日期時間
|
value.startDateTime | date-time |
任務的開始日期時間。 |
|
建立日期時間
|
value.createdDateTime | date-time |
建立任務的日期時間。 |
|
到期日時間
|
value.dueDateTime | date-time |
任務到期的日期時間。 |
|
有描述
|
value.hasDescription | boolean |
如果任務有描述，請設定為 True。 |
|
完成日期時間
|
value.completedDateTime | date-time |
任務完成的日期時間。 |
|
參考計數
|
value.referenceCount | integer |
任務上存在的外部參照數目。 |
|
Id
|
value.id | string |
任務的 ID。 |
GetPlanDetails_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
類別 1
|
categoryDescriptions.category1 | string |
類別 1. |
|
類別 2
|
categoryDescriptions.category2 | string |
類別 2. |
|
類別 3
|
categoryDescriptions.category3 | string |
類別 3. |
|
類別 4
|
categoryDescriptions.category4 | string |
類別 4. |
|
類別 5
|
categoryDescriptions.category5 | string |
類別 5. |
|
類別 6
|
categoryDescriptions.category6 | string |
第 6 類。 |
|
類別 7
|
categoryDescriptions.category7 | string |
類別 7. |
|
類別 8
|
categoryDescriptions.category8 | string |
類別 8. |
|
類別 9
|
categoryDescriptions.category9 | string |
類別 9. |
|
類別 10
|
categoryDescriptions.category10 | string |
類別 10. |
|
類別 11
|
categoryDescriptions.category11 | string |
類別 11. |
|
類別 12
|
categoryDescriptions.category12 | string |
類別 12. |
|
類別 13
|
categoryDescriptions.category13 | string |
類別 13. |
|
類別 14
|
categoryDescriptions.category14 | string |
類別 14. |
|
類別 15
|
categoryDescriptions.category15 | string |
類別 15. |
|
類別 16
|
categoryDescriptions.category16 | string |
類別 16. |
|
類別 17
|
categoryDescriptions.category17 | string |
類別 17. |
|
類別 18
|
categoryDescriptions.category18 | string |
類別 18. |
|
類別 19
|
categoryDescriptions.category19 | string |
類別 19. |
|
類別 20
|
categoryDescriptions.category20 | string |
類別 20. |
|
類別 21
|
categoryDescriptions.category21 | string |
類別 21. |
|
類別 22
|
categoryDescriptions.category22 | string |
類別 22. |
|
類別 23
|
categoryDescriptions.category23 | string |
類別 23. |
|
類別 24
|
categoryDescriptions.category24 | string |
類別 24. |
|
類別 25
|
categoryDescriptions.category25 | string |
類別 25. |
|
Id
|
id | string |
計劃詳細資料的 ID |