הזמנת משימות

אפשר לארגן את המשימות בסדר מסוים כך שיתאים להעדפות ולצרכים של המשתמשים. אפשר להעביר משימה לקבוצה אחרת (משימה אחת [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 גם במהלך יצירת משימה חדשה.