Вы можете организовать задачи в определенном порядке в соответствии с потребностями и предпочтениями пользователя. Задачу можно переместить под другую задачу ( parent
задачу) и/или переместить после другой задачи ( previous
).
Чтобы переместить задачу, отправьте аутентифицированный запрос POST
на следующий URL-адрес со следующими специальными параметрами:
-
parent
параметр - Указывает идентификатор родительской задачи, под которую должна быть вставлена новая задача; пропуск этого параметра помещает задачу на верхний уровень списка.
-
previous
параметр - Указывает идентификатор задачи, после которой должна быть вставлена новая задача; пропуск этого параметра помещает задачу на первую позицию подсписка.
URL-адрес имеет форму:
https://www.googleapis.com/tasks/v1/lists/taskListID
/tasks/taskID
/move?parent=parentTaskID
&previous=previousTaskID
С соответствующими значениями вместо taskListID
, taskID
, parentTaskID
и previousTaskID
.
Примечание . Специальное значение @default
taskListID
можно использовать для ссылки на список задач по умолчанию для аутентифицированного пользователя.
В случае успеха сервер отвечает кодом состояния 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());
result = service.tasks().move(tasklist='@default', task='taskID ', parent='parentTaskID ', previous='previousTaskID ').execute() # Print the new values. print result['parent'] print result['position']
$result = $service->moveTasks('taskID ', '@default', null, 'parentTaskID ', 'previousTaskID '); /* * Print the new values. */ echo $result->getParent(); echo $result->getPosition();
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
также можно использовать при создании новой задачи .