Puoi organizzare le attività in un ordine specifico in base alle esigenze e alle preferenze dell'utente. Un'attività può essere spostata in un'altra attività (parent) e/o può essere spostata dopo un'altra (previous).
Per spostare un'attività, invia una richiesta POST autenticata al seguente URL con questi parametri speciali:
- Il parametro
parent - Specifica l'ID dell'attività principale in cui deve essere inserita la nuova attività; se questo parametro viene omesso, l'attività viene posizionata al primo livello dell'elenco.
- Il parametro
previous - Specifica l'ID dell'attività dopo la quale deve essere inserita la nuova attività; omettendo questo parametro, l'attività viene posizionata nella prima posizione del sottoelenco.
L'URL ha il seguente formato:
https://www.googleapis.com/tasks/v1/lists/taskListID/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID
Con i valori appropriati al posto di taskListID, taskID, parentTaskID e previousTaskID.
Nota: il valore speciale taskListID @default può essere utilizzato per fare riferimento all'elenco di attività predefinito dell'utente autenticato.
Se l'operazione ha esito positivo, il server risponde con un codice di stato HTTP 200 OK e i nuovi dati dell'attività.
Esempio
Protocollo
Richiesta:
POST /tasks/v1/lists/@default/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID
Risposta:
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);
Nota: i parametri parent e previous possono essere utilizzati anche durante la creazione di una nuova attività.