Aufgaben sortieren

Sie können Aufgaben in einer bestimmten Reihenfolge organisieren, die den Bedürfnissen und Vorlieben der Nutzenden entspricht. Eine Aufgabe kann unter eine andere Aufgabe (parent Aufgabe) und/oder an eine andere Aufgabe (previous) verschoben werden.

Senden Sie zum Verschieben einer Aufgabe 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. Wird dieser Parameter weggelassen, wird die Aufgabe auf der obersten Ebene der Liste platziert.

Der Parameter previous

Gibt die ID der Aufgabe an, nach der die neue Aufgabe eingefügt werden soll. Wird dieser Parameter weggelassen, wird die Aufgabe an der ersten Position der Unterliste platziert.

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.