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 przenieść je po innym zadaniu (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 należy wstawić nowe zadanie. Jego pominięcie powoduje, że zadanie znajduje się na najwyższym poziomie listy.

Parametr previous

Określa identyfikator zadania, po którym należy wstawić nowe zadanie. Jego pominięcie powoduje umieszczenie zadania na pierwszej pozycji na liście podrzędnej.

Adres URL ma postać:

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

Ma odpowiednie wartości zamiast taskListID, taskID, parentTaskID i previousTaskID.

Uwaga: specjalna wartość taskListID @default może służyć 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żna też używać podczas tworzenia nowego zadania.