Nhiệm vụ đặt hàng

Bạn có thể sắp xếp các nhiệm vụ theo thứ tự cụ thể để phù hợp với nhu cầu và lựa chọn ưu tiên của người dùng. Bạn có thể di chuyển một việc cần làm vào một việc cần làm khác (parent) và/hoặc di chuyển ra sau một việc cần làm khác (previous).

Để di chuyển một công việc, hãy gửi yêu cầu POST đã xác thực đến URL sau với các tham số đặc biệt sau:

Thông số parent

Chỉ định mã nhận dạng của tác vụ mẹ mà bạn muốn chèn tác vụ mới vào đó. Việc bỏ qua tham số này sẽ đặt tác vụ lên cấp cao nhất của danh sách.

Thông số previous

Chỉ định mã nhận dạng của tác vụ mà sau đó bạn sẽ chèn tác vụ mới. Nếu bỏ qua tham số này, tác vụ sẽ được đặt ở vị trí đầu tiên của danh sách con.

URL có dạng:

https://www.googleapis.com/tasks/v1/lists/taskListID/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID

Bằng các giá trị thích hợp thay cho taskListID, taskID, parentTaskID và previousTaskID.

Lưu ý: Giá trị taskListID đặc biệt @default có thể dùng để tham chiếu đến danh sách tác vụ mặc định của người dùng đã xác thực.

Sau khi thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và dữ liệu công việc mới.

Ví dụ:

Giao thức

Yêu cầu:

POST /tasks/v1/lists/@default/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID

Phản hồi:

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']

1.199

$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);

Lưu ý: Bạn cũng có thể dùng các tham số parent và previous khi tạo một công việc mới.