سفارش وظایف

شما می توانید وظایف را به ترتیبی خاص و متناسب با نیازها و ترجیحات کاربر سازماندهی کنید. یک کار را می توان تحت کار دیگری (وظیفه 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']

PHP

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