Kolejność zadań

Zadania możesz porządkować w określonej kolejności, zgodnie z potrzebami i preferencjami użytkownika. Zadanie można przenieść do innego zadania (parent zadanie) lub innego zadania (previous).

Aby przenieść zadanie, wyślij uwierzytelnione żądanie POST na ten adres URL z tymi parametrami specjalnymi:

Parametr parent

Określa identyfikator zadania nadrzędnego, w którym ma zostać wstawione nowe zadanie. Pominięcie tego parametru umieszcza zadanie na najwyższym poziomie listy.

Parametr previous

Określa identyfikator zadania, po którym należy wstawić nowe zadanie. Pominięcie tego parametru umieszcza zadanie na pierwszej pozycji podlisty.

Adres URL ma postać:

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

Z odpowiednimi wartościami zamiast taskListID, taskID, parentTaskID i previousTaskID.

Uwaga: specjalnej wartości taskListID @default można używać do odwoływania się do domyślnej listy zadań uwierzytelnionego użytkownika.

Po pomyślnym zakończeniu serwer wysyła w odpowiedzi kod stanu HTTP 200 OK i nowe dane zadania.

Przykład

Protokół

Prośba:

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

Odpowiedź:

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

Uwaga: parametrów parent i previous możesz też użyć podczas tworzenia nowego zadania.