Sắp xếp Google Tasks

Bạn có thể sắp xếp các tác vụ theo một 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 sang một việc cần làm khác (parent việc cần làm) hoặc sang sau một việc cần làm khác (previous).

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

Tham số parent

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

Tham số previous

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

URL có định dạng như sau:

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ị đặc biệt taskListID@default để tham chiếu đến danh sách việc cần làm mặc định của người dùng đã xác thực.

Nếu 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 nhiệm vụ 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 trong khi tạo một tác vụ mới.