订购任务
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以按特定顺序整理任务,以满足用户的需求和偏好。一个任务可以移动到另一个任务(parent
任务)下和/或移动到另一个任务之后 (previous
)。

如需移动任务,请使用这些特殊参数向以下网址发送经过身份验证的 POST
请求:
parent
参数
- 指定应在其中插入新任务的父任务的 ID;省略此参数可将任务置于列表顶层。
previous
参数
- 指定在哪个任务的 ID 后插入新任务;如果省略此参数,系统会将任务放在子列表的第一个位置。
网址格式如下:
https://www.googleapis.com/tasks/v1/lists/taskListID
/tasks/taskID
/move?parent=parentTaskID
&previous=previousTaskID
使用适当的值代替 taskListID
、taskID
、parentTaskID
和 previousTaskID
。
注意:特殊的 taskListID
值 @default
可用于指代经过身份验证的用户的默认任务列表。
成功后,服务器会返回 HTTP 200 OK
状态代码和新的任务数据。
示例
协议
请求:
POST /tasks/v1/lists/@default/tasks/taskID
/move?parent=parentTaskID
&previous=previousTaskID
响应:
HTTP/1.1 200 OK
{
id: "taskID",
kind: "tasks#task",
selfLink: "https://www.googleapis.com/tasks/v1/lists/@default/tasks/taskID",
etag: "newETag",
title: "New Task",
notes: "Please complete me",
updated: "2010-10-15T11:30:00.000Z",
...,
parent: "parentTaskID",
position: "newPosition",
...
}
Java
import com.google.api.services.tasks.v1.Tasks.TasksOperations.Move;
...
Move move = service.tasks.move("@default", "taskID");
move.setParent("parentTaskID");
move.setPrevious("previousTaskID");
Task result = move.execute();
// Print the new values.
System.out.println(result.getParent());
System.out.println(result.getPosition());
Python
result = service.tasks().move(tasklist='@default', task='taskID', parent='parentTaskID', previous='previousTaskID').execute()
# Print the new values.
print result['parent']
print result['position']
PHP
$result = $service->moveTasks('taskID', '@default', null, 'parentTaskID', 'previousTaskID');
/*
* Print the new values.
*/
echo $result->getParent();
echo $result->getPosition();
.NET
Task result = service.Tasks.Move("@default", "taskID",
parent: "parentTaskID", previous: "previousTaskID").Fetch();
// Print the new values.
Console.WriteLine(result.Parent);
Console.WriteLine(result.Position);
注意:创建新任务时,也可以使用 parent
和 previous
参数。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-29。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[],[],null,["# Order Tasks\n\nYou can organize tasks in a specific order to suit the user's needs and preferences. A task can be moved under another task (`parent` task) and/or move to be after another task (`previous`).\n\nTo move a task, send an authenticated `POST` request to the following URL with these special parameters:\n\nThe `parent` parameter\n: Specifies the ID of the parent task under which the new task should be inserted; omitting this parameter places the task in the top level of the list.\n\nThe `previous` parameter\n: Specifies the ID of the task after which the new task should be inserted; omitting this parameter places the task in the first position of the sublist.\n\nThe URL is of the form: \n\n https://www.googleapis.com/tasks/v1/lists/taskListID/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID\n\nWith the appropriate values in place of `taskListID`, `taskID`, `parentTaskID` and `previousTaskID`.\n\n**Note** : The special `taskListID` value `@default` can be used to refer to the authenticated user's default task list.\n\nUpon success, the server responds with an HTTP `200 OK` status code and the new task data.\n\nExample\n=======\n\n### Protocol\n\nRequest: \n\n POST /tasks/v1/lists/@default/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID\n\nResponse: \n\n```http\nHTTP/1.1 200 OK\n\n{\n id: \"taskID\",\n kind: \"tasks#task\",\n selfLink: \"https://www.googleapis.com/tasks/v1/lists/@default/tasks/taskID\",\n etag: \"\u003cvar translate=\"no\"\u003enewETag\u003c/var\u003e\",\n title: \"New Task\",\n notes: \"Please complete me\",\n updated: \"2010-10-15T11:30:00.000Z\",\n ...,\n parent: \"\u003cvar translate=\"no\"\u003eparentTaskID\u003c/var\u003e\",\n position: \"\u003cvar translate=\"no\"\u003enewPosition\u003c/var\u003e\",\n ...\n}\n```\n\n### Java\n\n\n```java\nimport com.google.api.services.tasks.v1.Tasks.TasksOperations.Move;\n...\n\nMove move = service.tasks.move(\"@default\", \"\u003cvar translate=\"no\"\u003etaskID\u003c/var\u003e\");\nmove.setParent(\"\u003cvar translate=\"no\"\u003eparentTaskID\u003c/var\u003e\");\nmove.setPrevious(\"\u003cvar translate=\"no\"\u003epreviousTaskID\u003c/var\u003e\");\nTask result = move.execute();\n\n// Print the new values.\nSystem.out.println(result.getParent());\nSystem.out.println(result.getPosition());\n```\n\n\u003cbr /\u003e\n\n### Python\n\n\n```python\nresult = service.tasks().move(tasklist='@default', task='\u003cvar translate=\"no\"\u003etaskID\u003c/var\u003e', parent='\u003cvar translate=\"no\"\u003eparentTaskID\u003c/var\u003e', previous='\u003cvar translate=\"no\"\u003epreviousTaskID\u003c/var\u003e').execute()\n\n# Print the new values.\nprint result['parent']\nprint result['position']\n```\n\n\u003cbr /\u003e\n\n### PHP\n\n\u003cbr /\u003e\n\n```php\n$result = $service-\u003emoveTasks('\u003cvar translate=\"no\"\u003etaskID\u003c/var\u003e', '@default', null, '\u003cvar translate=\"no\"\u003eparentTaskID\u003c/var\u003e', '\u003cvar translate=\"no\"\u003epreviousTaskID\u003c/var\u003e');\n\n/*\n * Print the new values.\n */\necho $result-\u003egetParent();\necho $result-\u003egetPosition();\n```\n\n\u003cbr /\u003e\n\n### .NET\n\n\u003cbr /\u003e\n\n```transact-sql\nTask result = service.Tasks.Move(\"@default\", \"\u003cvar translate=\"no\"\u003etaskID\u003c/var\u003e\",\n parent: \"\u003cvar translate=\"no\"\u003eparentTaskID\u003c/var\u003e\", previous: \"\u003cvar translate=\"no\"\u003epreviousTaskID\u003c/var\u003e\").Fetch();\n// Print the new values.\nConsole.WriteLine(result.Parent);\nConsole.WriteLine(result.Position);\n```\n\n\u003cbr /\u003e\n\n**Note** : The `parent` and `previous` parameters can also be used while [creating a new task](#creating_task)."]]