Google Tasks sortieren

Sie können Aufgaben in einer bestimmten Reihenfolge anordnen, um den Bedürfnissen und Vorlieben des Nutzers gerecht zu werden. Sie können eine Aufgabe unter eine andere Aufgabe (parent) oder nach einer anderen Aufgabe (previous) verschieben.

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

Der Parameter parent

Gibt die ID der übergeordneten Aufgabe an, unter der die neue Aufgabe eingefügt werden soll. Wenn Sie diesen Parameter weglassen, 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. Wenn dieser Parameter weggelassen wird, wird die Aufgabe an der ersten Position der Unterliste platziert.

Die URL hat folgendes 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.