Commander Google Tasks

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

Pour déplacer une tâche, envoyez une requête POST authentifiée à l'URL suivante avec 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. Si vous omettez ce paramètre, la tâche est placée au niveau supérieur 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 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é.

Si l'opération aboutit, le serveur répond avec 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.