Nhiệm vụ đặt hàng

Bạn có thể sắp xếp các thao tác 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. Một việc cần làm có thể di chuyển sang một việc cần làm khác (parent việc cần làm) và/hoặc chuyển sang việc 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 kèm theo các tham số đặc biệt này:

Tham số parent

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

Tham số previous

Chỉ định mã của công việc mà sau đó công việc mới sẽ được chèn vào; khi bỏ qua tham số này, công việc 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

Với các giá trị thích hợp thay cho taskListID, taskID, parentTaskID và previousTaskID.

Lưu ý: Bạn có thể dùng giá trị taskListID đặc biệt @default để tham chiếu đến danh sách công việc 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']

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

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