Method: tasks.move

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

طلب HTTP

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

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

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

المعلمات
tasklist

string

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

string

معرّف المهمة

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

المعلمات
parent

string

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

الاستثناءات: 1- لا يمكن ضبط المهام المُسنَدة كمهمة رئيسية (تتضمّن مهام فرعية) أو نقلها ضمن مهمة رئيسية (تصبح مهام فرعية). 2. لا يمكن تداخل المهام المكتملة والمخفية، لذا يجب أن يكون الحقل الرئيسي فارغًا.
previous

string

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

الاستثناءات: 1- لا يمكن نقل المهام المكتملة والمخفية إلا إلى الموضع 0، لذا يجب أن يكون الحقل السابق فارغًا.
destinationTasklist

string

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

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

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