Aufgaben sortieren

Sie können Aufgaben in einer bestimmten Reihenfolge organisieren, um den Anforderungen und Präferenzen der Nutzenden gerecht zu werden. Eine Aufgabe kann unter eine andere Aufgabe verschoben werden (parent Aufgabe) und/oder an eine andere Aufgabe (previous) verschoben werden.

Wenn Sie eine Aufgabe verschieben möchten, senden Sie eine authentifizierte POST-Anfrage mit diesen speziellen Parametern an die folgende URL:

Der Parameter parent

Gibt die ID der übergeordneten Aufgabe an, unter der die neue Aufgabe eingefügt werden soll; Durch Weglassen dieses Parameters wird die Aufgabe an die oberste Ebene der Liste gesetzt.

Der Parameter previous

Gibt die ID der Aufgabe an, nach der die neue Aufgabe eingefügt werden soll. Durch Weglassen dieses Parameters wird die Aufgabe an die erste Position der Unterliste gesetzt.

Die URL hat das folgende Format:

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

Mit den entsprechenden Werten anstelle von taskListID, taskID, parentTaskID und previousTaskID.

Hinweis: Mit dem speziellen taskListID-Wert @default kann auf die Standardaufgabenliste des authentifizierten Nutzers verwiesen werden.

Bei Erfolg antwortet der Server mit dem HTTP-Statuscode 200 OK und den neuen Aufgabendaten.

Beispiel

Protokoll

Anfrage:

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

Antwort:

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

Hinweis: Die Parameter parent und previous können auch beim Erstellen einer neuen Aufgabe verwendet werden.