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

ID der neuen übergeordneten Aufgabe. Wenn die Aufgabe in die oberste Ebene verschoben wird, wird dieser Parameter weggelassen. Die als übergeordnete Aufgabe festgelegte Aufgabe muss in der Aufgabenliste vorhanden sein und darf nicht ausgeblendet sein. Zugewiesene Aufgaben können nicht als übergeordnete Aufgabe festgelegt (Unteraufgaben haben) oder in eine übergeordnete Aufgabe verschoben (Unteraufgaben werden) werden. Optional.
previous

string

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. Optional.
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. Optional.

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.