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 avec ces paramètres spéciaux:

Paramètre parent

Spécifie l'ID de la tâche parente sous laquelle la nouvelle tâche doit être insérée. Si vous omettez ce paramètre, la tâche sera placée 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. Si vous omettez ce paramètre, la tâche est placée en première position de la sous-liste.

L'URL se présente sous la forme suivante:

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

Utilisez 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é.

Si l'opération réussit, le serveur renvoie un code d'état HTTP 200 OK et les nouvelles données de la 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.