Method: tasks.move

将指定任务移至目标任务列表中的其他位置。如果未指定目标列表，则任务会在其当前列表中移动。这可能包括将其作为子任务置于新父任务下和/或将其移至同级任务中的不同位置。用户每项任务最多可以有 2,000 项子任务。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
tasklist

string

任务列表标识符。
task

string

任务标识符。

查询参数

参数
parent

string

新的父级任务标识符。如果将任务移至顶层，则省略此参数。不能将已分配的任务设置为上级任务（包含子任务），也不能将已分配的任务移至父任务下（成为子任务）。可选。
previous

string

新的上一个同级任务标识符。如果将任务移至同级任务中的首位，此参数会被省略。可选。
destinationTasklist

string

可选。目标任务列表标识符。如果设置了此字段，则任务会从任务列表移至目标任务列表列表。否则，系统会将任务移至其当前列表中。目前无法在列表之间移动周期性任务。可选。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 Task 实例。

授权范围

需要以下 OAuth 范围：

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

有关详情，请参阅授权指南。