Method: tasks.move

Die angegebene Aufgabe wird an eine andere Position in der Zielaufgabenliste verschoben. Wenn die Zielliste nicht angegeben ist, wird die Aufgabe innerhalb der aktuellen Liste verschoben. Sie können sie beispielsweise als untergeordnete Aufgabe unter einer neuen übergeordneten Aufgabe platzieren und/oder sie an eine andere Position unter ihren gleichrangigen Aufgaben verschieben. Ein Nutzer kann pro Aufgabe bis zu 2.000 Unteraufgaben haben.

HTTP-Anfrage

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
tasklist

string

ID der Aufgabenliste.
task

string

Aufgaben-ID.

Abfrageparameter

Parameter
parent

string

Optional. ID der neuen übergeordneten Aufgabe. Wenn die Aufgabe in die oberste Ebene verschoben wird, wird dieser Parameter weggelassen. Die als übergeordnet festgelegte Aufgabe muss in der Aufgabenliste vorhanden sein und darf nicht ausgeblendet sein.

Ausnahmen: 1. Zugewiesene Aufgaben können nicht als übergeordnete Aufgabe festgelegt (Unteraufgaben haben) oder in eine übergeordnete Aufgabe verschoben (Unteraufgaben werden) werden. 2. Aufgaben, die abgeschlossen und ausgeblendet sind, können nicht verschachtelt werden. Das übergeordnete Feld muss also leer sein.
previous

string

Optional. Neue ID der vorherigen übergeordneten Aufgabe. Wenn die Aufgabe an die erste Position unter ihren Geschwistern verschoben wird, wird dieser Parameter weggelassen. Die als vorherige Aufgabe festgelegte Aufgabe muss in der Aufgabenliste vorhanden sein und darf nicht ausgeblendet sein.

Ausnahmen: 1. Aufgaben, die abgeschlossen und ausgeblendet sind, können nur an Position 0 verschoben werden. Das vorherige Feld muss also leer sein.
destinationTasklist

string

Optional. ID der Zielaufgabenliste. Wenn diese Option festgelegt ist, wird die Aufgabe aus der Aufgabenliste in die Zielaufgabenliste verschoben. Andernfalls wird die Aufgabe innerhalb der aktuellen Liste verschoben. Wiederkehrende Aufgaben können derzeit nicht zwischen Listen verschoben werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Task.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/tasks

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.