ترتيب "مهام Google"

يمكنك ترتيب المهام بترتيب معيّن بما يتناسب مع احتياجات المستخدم وخياراته المفضّلة. يمكنك نقل مهمة لتصبح مهمة فرعية ضمن مهمة أخرى (مهمة parent) أو لتصبح بعد مهمة أخرى (previous).

واجهة "مهام Google"، تعرض المهام منظَّمة بترتيب هرمي وتسلسلي.

لنقل مهمة، أرسِل طلب 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());

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 أثناء إنشاء مهمة جديدة.