작업 정렬

사용자의 필요와 선호도에 맞게 특정 순서로 작업을 정리할 수 있습니다. 할 일을 다른 할 일 (parent 할 일) 아래로 이동하거나 다른 할 일 (previous) 뒤로 이동할 수 있습니다.

작업을 이동하려면 아래의 특수 매개변수를 사용하여 인증된 POST 요청을 다음 URL로 전송합니다.

parent 매개변수

새 작업을 삽입해야 하는 상위 작업의 ID를 지정합니다. 이 매개변수를 생략하면 작업이 목록의 최상위 수준에 배치됩니다.

previous 매개변수

새 작업이 삽입되어야 하는 작업의 ID를 지정합니다. 이 매개변수를 생략하면 작업이 하위 목록의 첫 번째 위치에 배치됩니다.

URL 형식은 다음과 같습니다.

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",
  ...
}

자바

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 매개변수는 새 작업을 생성하는 동안에도 사용할 수 있습니다.