將指定工作移至目的地工作清單中的其他位置。如未指定目的地清單,則會將工作移至目前的清單中。這可能包含將子工作當做新父項下的子項工作,和/或將其移至同層級任務中的其他位置。每位使用者每個工作最多可以有 2,000 個子工作。
HTTP 要求
POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
tasklist |
工作清單 ID。 |
task |
工作 ID。 |
查詢參數
參數 | |
---|---|
parent |
新增父項工作 ID。如果工作移至頂層,會省略這項參數。指派的工作無法設為上層工作 (含有子工作),也不能移到上層工作 (成為子工作) 之下。選用。 |
previous |
新的舊版同層工作 ID。如果工作移至同層級項目的第一個位置,會省略這個參數。選用。 |
destinationTasklist |
選用設定。目的地工作清單 ID。如果已設定,系統會將工作從工作清單移至 destinationTasklist 清單。否則,工作會移至目前的清單中。目前無法在清單之間移動週期性工作。選用。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體會包含 Task
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/tasks
詳情請參閱授權指南。