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. Dazu kann es gehören, die Aufgabe als untergeordnete Aufgabe unter einer neuen übergeordneten Aufgabe zu platzieren und/oder sie an eine andere Position unter den zugehörigen Aufgaben zu 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

Die 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 und wiederkehrende Aufgaben können nicht als übergeordnete Aufgaben 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.