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

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

请求正文

请求正文必须为空。

响应正文

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅授权指南。