طلب المهام

يمكنك تنظيم المهام بترتيب معين لتناسب احتياجات المستخدم وتفضيلاته. يمكن نقل مهمة ضمن مهمة أخرى (مهمة واحدة (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",
  ...
}

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