Attività di un ordine

Puoi organizzare le attività in un ordine specifico in base alle esigenze e alle preferenze dell'utente. Un'attività può essere spostata sotto un'altra attività (parent attività) e/o posizionata dopo un'altra attività (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 ometti questo parametro, l'attività viene inserita nel livello superiore dell'elenco.
Il parametro previous
Specifica l'ID dell'attività dopo la quale deve essere inserita la nuova attività. Se ometti questo parametro, l'attività viene posizionata nella prima posizione del sottoelenco.

L'URL ha questo formato:

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

Usando i valori appropriati al posto di taskListID, taskID, parentTaskID e previousTaskID.

Nota: il valore taskListID speciale @default può essere utilizzato per fare riferimento all'elenco di attività predefinito dell'utente autenticato.

Se l'operazione riesce, il server risponde con un codice di stato HTTP 200 OK e i dati delle nuove 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à.