نقل المهمة المحددة إلى موضع آخر في قائمة مهام الوجهة. إذا لم يتم تحديد قائمة الوجهات، يتم نقل المهمة ضمن القائمة الحالية. يمكن أن يشمل ذلك وضعها كمهمة فرعية تحت الوالد الجديد و/أو نقلها إلى موضع مختلف بين المهام التابعة. يمكن للمستخدم تنفيذ ما يصل إلى 2000 مهمة فرعية لكل مهمة.
طلب HTTP
POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
tasklist |
معرِّف قائمة المهام. |
task |
معرِّف المهمة. |
معلمات طلب البحث
| المعلمات | |
|---|---|
parent |
معرّف المهمة الرئيسية الجديد وإذا تم نقل المهمة إلى المستوى الأعلى، سيتم حذف هذه المَعلمة. لا يمكن ضبط المهام المُسنَدة كمهمة رئيسية (تحتوي على مهام فرعية) ولا يمكن نقلها ضمن مهمة رئيسية (تصبح مهام فرعية). اختياريّ. |
previous |
المعرّف الجديد للمهمة التابعة السابقة وإذا تم نقل المهمة إلى الموضع الأول بين العناصر التابعة لها، سيتم حذف هذه المَعلمة. اختياريّ. |
destinationTasklist |
اختياريّ. معرّف قائمة مهام الوجهة. في حال ضبط المهمة، يتم نقلها من قائمة المهام إلى القائمة DestinationTasklist. وبخلاف ذلك، يتم نقل المهمة إلى قائمتها الحالية. لا يمكن حاليًا نقل المهام المتكرّرة بين القوائم. اختياريّ. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Task.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/tasks
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.