訂購 Google Tasks

你可以按照特定順序整理工作，以符合使用者的需求和偏好。 你可以將工作移到其他工作下方 (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 參數。