Tâches de commande

Vous pouvez organiser les tâches dans un ordre spécifique pour répondre aux besoins et aux préférences de l'utilisateur. Une tâche peut être déplacée sous une autre tâche (parent tâche) et/ou placée après une autre tâche (previous).

Pour déplacer une tâche, envoyez une requête POST authentifiée à l'URL suivante en incluant les paramètres spéciaux suivants:

Paramètre parent

Spécifie l'ID de la tâche parente sous laquelle la nouvelle tâche doit être insérée. L'omission de ce paramètre place la tâche au premier niveau de la liste.

Paramètre previous

Spécifie l'ID de la tâche après laquelle la nouvelle tâche doit être insérée. l'omission de ce paramètre place la tâche en première position de la sous-liste.

L'URL se présente au format suivant:

https://www.googleapis.com/tasks/v1/lists/taskListID/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID

Avec les valeurs appropriées à la place de taskListID, taskID, parentTaskID et previousTaskID.

Remarque: La valeur spéciale taskListID @default peut être utilisée pour faire référence à la liste de tâches par défaut de l'utilisateur authentifié.

En cas de réussite, le serveur répond avec un code d'état HTTP 200 OK et les nouvelles données de tâche.

Exemple

Protocole

Requête :

POST /tasks/v1/lists/@default/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID

Réponse :

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);

Remarque: Les paramètres parent et previous peuvent également être utilisés lors de la création d'une tâche.