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

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

previous

string

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

destinationTasklist

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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