הזמנת משימות

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

כדי להעביר משימה, צריך לשלוח בקשת POST מאומתת לכתובת ה-URL הבאה עם הפרמטרים המיוחדים האלה:

הפרמטר parent

ההגדרה קובעת את המזהה של משימת ההורה שמתחתיה יש להוסיף את המשימה החדשה. אם הפרמטר הזה לא נכלל, היא תוצג ברמה העליונה של הרשימה.

הפרמטר previous

ההגדרה קובעת את מזהה המשימה שאחריו יש להוסיף את המשימה החדשה. אם הפרמטר לא יתייחס אליה, היא תמוקם במיקום הראשון ברשימת המשנה.

כתובת האתר היא בתבנית הבאה:

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

עם הערכים המתאימים במקום taskListID, taskID, parentTaskID ו-previousTaskID.

הערה: אפשר להשתמש בערך taskListID המיוחד @default כדי להפנות לרשימת משימות ברירת המחדל של המשתמש המאומת.

לאחר הצלחה, השרת מגיב באמצעות קוד מצב HTTP 200 OK ונתוני המשימה החדשה.

דוגמה

פרוטוקול

הבקשה:

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 גם כשיוצרים משימה חדשה.