Method: tasks.move

將指定工作移至目的地工作清單中的其他位置。如未指定目的地清單,則會將工作移至目前的清單中。這可能包含將子工作當做新父項下的子項工作,和/或將其移至同層級任務中的其他位置。每位使用者每個工作最多可以有 2,000 個子工作。

HTTP 要求

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
tasklist

string

工作清單 ID。

task

string

工作 ID。

查詢參數

參數
parent

string

新增父項工作 ID。如果工作移至頂層,會省略這項參數。指派的工作無法設為上層工作 (含有子工作),也不能移到上層工作 (成為子工作) 之下。選用。

previous

string

新的舊版同層工作 ID。如果工作移至同層級項目的第一個位置,會省略這個參數。選用。

destinationTasklist

string

選用設定。目的地工作清單 ID。如果已設定,系統會將工作從工作清單移至 destinationTasklist 清單。否則,工作會移至目前的清單中。目前無法在清單之間移動週期性工作。選用。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 Task 的執行例項。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/tasks

詳情請參閱授權指南