Method: tasks.move

نقل المهمة المحددة إلى موضع آخر في قائمة مهام الوجهة. إذا لم يتم تحديد قائمة الوجهات، يتم نقل المهمة ضمن القائمة الحالية. يمكن أن يشمل ذلك وضعها كمهمة فرعية تحت الوالد الجديد و/أو نقلها إلى موضع مختلف بين المهام التابعة. يمكن للمستخدم تنفيذ ما يصل إلى 2000 مهمة فرعية لكل مهمة.

طلب HTTP

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
tasklist

string

معرِّف قائمة المهام.
task

string

معرِّف المهمة.

معلمات طلب البحث

المعلمات
parent

string

معرّف المهمة الرئيسية الجديد وإذا تم نقل المهمة إلى المستوى الأعلى، سيتم حذف هذه المَعلمة. لا يمكن ضبط المهام المُسنَدة كمهمة رئيسية (تحتوي على مهام فرعية) ولا يمكن نقلها ضمن مهمة رئيسية (تصبح مهام فرعية). اختياريّ.
previous

string

المعرّف الجديد للمهمة التابعة السابقة وإذا تم نقل المهمة إلى الموضع الأول بين العناصر التابعة لها، سيتم حذف هذه المَعلمة. اختياريّ.
destinationTasklist

string

اختياريّ. معرّف قائمة مهام الوجهة. في حال ضبط المهمة، يتم نقلها من قائمة المهام إلى القائمة DestinationTasklist. وبخلاف ذلك، يتم نقل المهمة إلى قائمتها الحالية. لا يمكن حاليًا نقل المهام المتكرّرة بين القوائم. اختياريّ.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Task.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/tasks

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.