איך מסדרים את המשימות ב-Google Tasks

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

ממשק Google Tasks שבו המשימות מאורגנות בסדר היררכי ורציף.

כדי להעביר משימה, שולחים בקשת 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 כשיוצרים משימה חדשה.