Method: tasks.move

Déplace la tâche spécifiée vers une autre position dans la liste de tâches de destination. Si la liste de destination n'est pas spécifiée, la tâche est déplacée dans sa liste actuelle. Par exemple, vous pouvez la placer en tant que tâche enfant sous un nouveau parent et/ou la déplacer vers une autre position parmi ses tâches sœurs. Un utilisateur peut avoir jusqu'à 2 000 tâches secondaires par tâche.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
tasklist

string

Identifiant de la liste de tâches.
task

string

Identifiant de la tâche.

Paramètres de requête

Paramètres
parent

string

Nouvel identifiant de la tâche parente. Si la tâche est déplacée au premier niveau, ce paramètre est omis. Les tâches attribuées ne peuvent pas être définies en tant que tâches parentes (contenant des tâches secondaires) ni déplacées vers une tâche parente (devenir des tâches secondaires). Facultatif.
previous

string

Nouvel identifiant de la tâche frère précédent. Si la tâche est déplacée en première position parmi ses frères et sœurs, ce paramètre est omis. Facultatif.
destinationTasklist

string

Facultatif. Identifiant de la liste de tâches de destination. Si cette option est définie, la tâche est déplacée de la liste des tâches vers la liste des tâches de destination. Sinon, la tâche est déplacée dans sa liste actuelle. Pour le moment, il n'est pas possible de déplacer les tâches récurrentes d'une liste à une autre. Facultatif.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Task.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez le Guide relatif aux autorisations.