אתם יכולים לארגן את המשימות בסדר מסוים שיתאים לצרכים ולהעדפות של המשתמש.
אפשר להעביר משימה מתחת למשימה אחרת (parent) או אחרי משימה אחרת (previous).

כדי להעביר משימה, שולחים בקשת POST מאומתת לכתובת ה-URL הבאה עם הפרמטרים המיוחדים הבאים:
- הפרמטר
parent
- מציין את המזהה של משימת האב שמתחתיה צריך להוסיף את המשימה החדשה. אם לא מציינים את הפרמטר הזה, המשימה ממוקמת ברמה העליונה של הרשימה.
- הפרמטר
previous - מציין את המזהה של המשימה שאחריה צריך להוסיף את המשימה החדשה. אם לא מציינים את הפרמטר הזה, המשימה ממוקמת במיקום הראשון ברשימת המשנה.
כתובת ה-URL היא בפורמט הבא:
https://www.googleapis.com/tasks/v1/lists/taskListID/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID
עם הערכים המתאימים במקום taskListID, taskID, parentTaskID ו-previousTaskID.
הערה: אפשר להשתמש בערך המיוחד taskListID
@default כדי להתייחס לרשימת המשימות שמוגדרת כברירת מחדל של המשתמש המאומת.
אם הפעולה מצליחה, השרת משיב עם קוד סטטוס 200 OK של HTTP ועם נתוני המשימה החדשים.
דוגמה
פרוטוקול
בקשה:
POST /tasks/v1/lists/@default/tasks/taskID/move?parent=parentTaskID\ &previous=previousTaskID
תשובה:
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);
הערה: אפשר להשתמש גם בפרמטרים parent ו-previous כשיוצרים משימה חדשה.