Zamawianie Listy zadań Google

Możesz uporządkować zadania w określonej kolejności, aby dopasować je do potrzeb i preferencji użytkownika. Możesz przenieść zadanie pod inne zadanie (parent) lub za inne zadanie (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, pod którym ma zostać wstawione nowe zadanie. Pominięcie tego parametru spowoduje umieszczenie zadania na najwyższym poziomie listy.

Parametr previous

Określa identyfikator zadania, po którym ma zostać wstawione nowe zadanie. Pominięcie tego parametru spowoduje umieszczenie zadania na pierwszym miejscu podlisty.

Adres URL ma format:

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żyć do odwoływania się do domyślnej listy zadań uwierzytelnionego użytkownika.

Jeśli operacja się powiedzie, serwer odpowie kodem stanu HTTP 200 OK i nowymi danymi 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: podczas tworzenia nowego zadania można też używać parametrów parent i previous.