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