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。如果已設定，系統會將工作從 tasklist 移至 destinationTasklist 清單。否則，系統會在目前的清單中移動工作。目前無法在清單之間移動週期性工作。選填。

要求主體

要求主體必須為空白。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱授權指南。