طلب المهام

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