REST Resource: tasks

संसाधन: टास्क

जेएसओएन के काेड में दिखाना
{
  "kind": string,
  "id": string,
  "etag": string,
  "title": string,
  "updated": string,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": string,
  "completed": string,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
    {
      "type": string,
      "description": string,
      "link": string
    }
  ],
  "webViewLink": string
}
फ़ील्ड
kind

string

सिर्फ़ आउटपुट के लिए. संसाधन का टाइप. ऐसा हमेशा "tasks#task" होता है.

id

string

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

etag

string

संसाधन का ETag.

title

string

टास्क का टाइटल. ज़्यादा से ज़्यादा 1,024 वर्ण इस्तेमाल किए जा सकते हैं.

updated

string

सिर्फ़ आउटपुट के लिए. टास्क में पिछली बार बदलाव किए जाने का समय (आरएफ़सी 3339 टाइमस्टैंप के तौर पर).

parent

string

सिर्फ़ आउटपुट के लिए. पैरंट टास्क आइडेंटिफ़ायर. अगर यह टॉप लेवल का टास्क है, तो इसे छोड़ दिया जाता है. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है. टास्क को किसी दूसरे पैरंट लेवल पर या टॉप लेवल पर ले जाने के लिए, "ले जाएं" तरीके का इस्तेमाल करें.

position

string

सिर्फ़ आउटपुट के लिए. स्ट्रिंग, एक ही पैरंट टास्क या टॉप लेवल पर, इसके सिबलिंग टास्क के बीच, टास्क की जगह के बारे में बताती है. अगर यह स्ट्रिंग लेक्सिकोग्राफ़िक क्रम के मुताबिक किसी दूसरे टास्क की रैंक स्ट्रिंग से बड़ी है, तो उस टास्क को उसी पैरंट टास्क के तहत दूसरे टास्क के बाद (या टॉप लेवल) पर रखा जाता है. किसी टास्क को दूसरी जगह ले जाने के लिए, "ले जाएं" तरीके का इस्तेमाल करें.

notes

string

टास्क के बारे में जानकारी देने वाले नोट. ज़रूरी नहीं. ज़्यादा से ज़्यादा 8,192 वर्ण इस्तेमाल किए जा सकते हैं.

status

string

टास्क की स्थिति. यह "needsAction" या "completed" है.

due

string

टास्क पूरा होने की तारीख (आरएफ़सी 3339 टाइमस्टैंप के तौर पर). ज़रूरी नहीं. पूरा होने की तारीख में सिर्फ़ तारीख की जानकारी रिकॉर्ड होती है. आखिरी तारीख सेट करते समय टाइमस्टैंप के समय वाले हिस्से को खारिज कर दिया जाता है. एपीआई की मदद से, किसी टास्क को पूरा होने में लगने वाले समय की जानकारी को पढ़ा या लिखा नहीं जा सकता.

completed

string

टास्क पूरा होने की तारीख (आरएफ़सी 3339 टाइमस्टैंप के तौर पर). अगर टास्क पूरा नहीं हुआ है, तो यह फ़ील्ड छोड़ दिया जाता है.

deleted

boolean

फ़्लैग बताता है कि टास्क मिटाया गया है या नहीं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है.

hidden

boolean

फ़्लैग बताता है कि टास्क छिपा है या नहीं. ऐसा तब होता है, जब टास्क की सूची को पिछली बार हटाते समय, किसी टास्क को 'पूरा हो गया' के तौर पर मार्क किया गया हो. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.

links[].type

string

लिंक का टाइप, जैसे कि "ईमेल".

links[].description

string

ब्यौरा. HTML में, <a> और </a> के बीच सब कुछ बोलें.

links[].link

string

यूआरएल.

तरीके

clear

पूरे हो चुके सभी टास्क को तय की गई टास्क की सूची से हटाता है.

delete

टास्क की सूची से यह टास्क मिटाता है.

get

तय किया गया टास्क लौटाता है.

insert

तय की गई टास्क सूची में कोई नया टास्क बनाता है.

list

तय की गई टास्क सूची में मौजूद सभी टास्क दिखाता है.

move

चुने गए टास्क को टास्क सूची में किसी दूसरी जगह पर ले जाता है.

patch

तय किए गए टास्क को अपडेट करता है.

update

तय किए गए टास्क को अपडेट करता है.