سفارش وظایف گوگل

شما می‌توانید وظایف را به ترتیب خاصی متناسب با نیازها و ترجیحات کاربر سازماندهی کنید. می‌توانید یک وظیفه را زیر وظیفه دیگری (وظیفه 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 ‎ می‌تواند برای ارجاع به لیست وظایف پیش‌فرض کاربر احراز هویت شده استفاده شود.

در صورت موفقیت، سرور با کد وضعیت 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",
  ...
}

جاوا

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());

پایتون

result = service.tasks().move(tasklist='@default', task='taskID',\
                              parent='parentTaskID',\
                              previous='previousTaskID').execute()

# Print the new values.
print result['parent']
print result['position']

پی اچ پی

$result = $service->moveTasks('taskID', '@default', null, 'parentTaskID', 'previousTaskID');

/*
 * Print the new values.
 */
echo $result->getParent();
echo $result->getPosition();

دات نت

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 را می‌توان هنگام ایجاد یک وظیفه جدید نیز استفاده کرد.