Method: tasks.move

चुने गए टास्क को डेस्टिनेशन टास्क की सूची में किसी दूसरी जगह पर ले जाता है. अगर डेस्टिनेशन की सूची नहीं दी गई है, तो टास्क को उसकी मौजूदा सूची में ही ले जाया जाता है. इसमें, किसी नए पैरंट के तहत चाइल्ड टास्क के तौर पर डालना और/या उसे अपने सिबलिंग टास्क के बीच किसी दूसरी जगह पर ले जाना शामिल है. किसी उपयोगकर्ता के पास हर टास्क के लिए, ज़्यादा से ज़्यादा 2,000 सबटास्क हो सकते हैं.

एचटीटीपी अनुरोध

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

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
tasklist

string

टास्क की सूची का आइडेंटिफ़ायर.
task

string

टास्क आइडेंटिफ़ायर.

क्वेरी पैरामीटर

पैरामीटर
parent

string

ज़रूरी नहीं. पैरंट टास्क का नया आइडेंटिफ़ायर. अगर टास्क को सबसे ऊपर ले जाया जाता है, तो इस पैरामीटर को शामिल नहीं किया जाता. पैरंट के तौर पर सेट किया गया टास्क, टास्क की सूची में मौजूद होना चाहिए. साथ ही, उसे छिपाया नहीं जा सकता.

अपवाद: 1. असाइन किए गए और बार-बार होने वाले टास्क को पैरंट टास्क (उनमें सबटास्क होते हैं) के तौर पर सेट नहीं किया जा सकता. इसके अलावा, उन्हें पैरंट टास्क के नीचे नहीं ले जाया जा सकता (वे सबटास्क बन जाते हैं). 2. पूरे हो चुके और छिपे हुए टास्क को नेस्ट नहीं किया जा सकता. इसलिए, पेरंट फ़ील्ड खाली होना चाहिए.
previous

string

ज़रूरी नहीं. पिछले सिबलिंग टास्क का नया आइडेंटिफ़ायर. अगर टास्क को अपने भाई-बहनों के बीच पहली पोज़िशन पर ले जाया जाता है, तो इस पैरामीटर को छोड़ दिया जाता है. 'पिछला' के तौर पर सेट किया गया टास्क, टास्क की सूची में मौजूद होना चाहिए. साथ ही, उसे छिपाया नहीं जा सकता.

अपवाद: 1. पूरे हो चुके और छिपे हुए टास्क को सिर्फ़ 0 नंबर की जगह पर ले जाया जा सकता है. इसलिए, पिछले फ़ील्ड में कोई आइटम नहीं होना चाहिए.
destinationTasklist

string

ज़रूरी नहीं. डेस्टिनेशन टास्क की सूची का आइडेंटिफ़ायर. अगर यह सेट है, तो टास्क को टास्कलिस्ट से destinationTasklist सूची में ले जाया जाता है. ऐसा न करने पर, टास्क को उसकी मौजूदा सूची में ले जाया जाता है. फ़िलहाल, बार-बार होने वाले टास्क को एक सूची से दूसरी सूची में नहीं ले जाया जा सकता.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में Task का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.