تنقل المهمة المحدّدة إلى موضع آخر في قائمة المهام المقصودة. في حال عدم تحديد قائمة الوجهة، يتم نقل المهمة ضمن قائمتها الحالية. ويمكن أن يشمل ذلك وضعها كمهمة فرعية ضمن مهمة رئيسية جديدة و/أو نقلها إلى موضع مختلف بين المهام الشقيقة. يمكن أن يمتلك المستخدم ما يصل إلى 2,000 مهمة فرعية لكل مهمة.
طلب HTTP
POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move
معرّف المهمة الرئيسية الجديد في حال نقل المهمة إلى المستوى الأعلى، يتم حذف هذه المَعلمة. يجب أن تكون المهمة التي تم ضبطها كمهمة رئيسية متوفّرة في قائمة المهام ولا يمكن إخفاؤها. لا يمكن ضبط المهام المُسنَدة كمهمة رئيسية (تتضمّن مهام فرعية) أو نقلها ضمن مهمة رئيسية (تصبح مهام فرعية). اختيارية:
previous
string
معرّف جديد لمهمة الأخ الشقيق السابق إذا تم نقل المهمة إلى الموضع الأول بين المهام الشقيقة، يتم حذف هذه المَعلمة. يجب أن تكون المهمة التي تم ضبطها على أنّها سابقة موجودة في قائمة المهام ولا يمكن إخفاؤها. اختيارية:
destinationTasklist
string
اختيارية: معرّف قائمة المهام المقصودة في حال ضبطها، يتم نقل المهمة من قائمة المهام إلى قائمة "قائمة المهام المقصودة". بخلاف ذلك، يتم نقل المهمة ضمن قائمتها الحالية. لا يمكن حاليًا نقل المهام المتكرّرة بين القوائم. اختيارية:
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Task.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/tasks
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
تاريخ التعديل الأخير: 2024-12-20 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-12-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Moves a specified task to a new location within a task list, potentially changing its parent or sibling order."],["Requires providing the task and task list identifiers in the request path."],["Optionally allows specifying a new parent, previous sibling, or destination task list using query parameters."],["Utilizes an empty request body and returns the updated task details in the response."],["Needs authorization with the `https://www.googleapis.com/auth/tasks` scope."]]],["This document outlines the process for moving a task within or between task lists using the Tasks API. Key actions include making a `POST` request to the specified URL, providing the `tasklist` and `task` identifiers as path parameters. Optional query parameters like `parent`, `previous`, and `destinationTasklist` allow for specifying the task's new position and list. The request body must be empty. A successful operation returns a `Task` object. Authorization requires the `https://www.googleapis.com/auth/tasks` scope.\n"]]
