將指定的工作移至目的地工作清單中的其他位置。如果未指定目的地清單，系統會在目前清單中移動工作。這包括將子項工作放在新父項下方，以及/或者將子項工作移至相依工作中的不同位置。使用者每項工作最多可建立 2,000 個子工作。
HTTP 要求
POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
tasklist |
工作清單 ID。 |
task |
工作 ID。 |
查詢參數
| 參數 | |
|---|---|
parent |
(非必要) 新的父項工作 ID。如果工作已移至頂層，則會省略這項參數。設為父項的工作必須存在於工作清單中，且無法隱藏。 例外狀況：1. 已指派的週期性工作無法設為父項工作 (含有子工作)，也無法移至父項工作 (成為子工作)。2. 已完成且已隱藏的工作無法巢狀，因此父項欄位必須為空白。 |
previous |
(非必要) 新的前一個同層工作 ID。如果工作已移至同層工作中的首要位置，則會略過這個參數。以「先前」為名的任務集必須存在於工作清單中，且無法隱藏。 例外狀況：1. 已完成且隱藏的工作只能移至位置 0，因此前一個欄位必須為空白。 |
destinationTasklist |
(非必要) 目的地工作清單 ID。如果已設定，系統會將工作從 tasklist 移至 destinationTasklist 清單。否則，系統會在目前的清單中移動工作。目前無法在清單之間移動週期性工作。 |
要求主體
要求主體必須為空白。
回應主體
如果成功，回應主體會包含 Task 的執行例項。
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/tasks
詳情請參閱授權指南。