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

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

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

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

links[].description

string

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

links[].link

string

यूआरएल.

तरीके

clear

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

delete

टास्क की सूची से चुने गए टास्क को मिटाता है.

get

बताए गए टास्क को दिखाता है.

insert

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

list

बताई गई टास्क सूची के सभी टास्क दिखाता है.

move

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

patch

चुने गए टास्क को अपडेट करता है.

update

चुने गए टास्क को अपडेट करता है.