REST Resource: tasks

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

JSON के काेड में दिखाना 
{
  "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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
फ़ील्ड
kind

string

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

string

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

string

संसाधन का ETag.
title

string

टास्क का टाइटल. ज़्यादा से ज़्यादा लंबाई: 1024 वर्ण.
updated

string

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

string

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

string

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

string

टास्क के बारे में जानकारी देने वाले नोट. Google Docs से असाइन किए गए टास्क में नोट नहीं जोड़े जा सकते. ज़रूरी नहीं. ज़्यादा से ज़्यादा लंबाई: 8192 वर्ण.
status

string

टास्क का स्टेटस. यह "needsAction" या "completed" में से कोई एक होता है.
due

string

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

string

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

boolean

फ़्लैग से पता चलता है कि टास्क मिटाया गया है या नहीं. असाइन किए गए टास्क के लिए, यह फ़ील्ड सिर्फ़ पढ़ने के लिए है. इन्हें सिर्फ़ tasks.delete को कॉल करके मिटाया जा सकता है. ऐसा करने पर, असाइन किया गया टास्क और ओरिजनल टास्क, दोनों (Docs या Chat स्पेस में) मिट जाते हैं. सिर्फ़ असाइन किया गया टास्क मिटाने के लिए, असाइनमेंट के पेज पर जाएं और वहां से टास्क को अनअसाइन करें. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है.
hidden

boolean

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

string

लिंक का टाइप, जैसे कि "email", "generic", "chat_message", "keep_note".
links[].description

string

ब्यौरा (यह खाली हो सकता है).
links[].link

string

यूआरएल.
assignmentInfo

object (AssignmentInfo)

सिर्फ़ आउटपुट के लिए. असाइन किए गए टास्क के लिए कॉन्टेक्स्ट की जानकारी. किसी उपयोगकर्ता को टास्क असाइन किया जा सकता है. फ़िलहाल, Docs और Chat स्पेस जैसे प्लैटफ़ॉर्म से ऐसा किया जा सकता है. यह फ़ील्ड, मौजूदा उपयोगकर्ता को असाइन किए गए टास्क के लिए पॉप्युलेट होता है. साथ ही, यह बताता है कि टास्क को कहां से असाइन किया गया था. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.

AssignmentInfo

टास्क असाइन करने के सोर्स (दस्तावेज़, चैट स्पेस) के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  // Union field surface_info can be only one of the following:
  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
  // End of list of possible types for union field surface_info.
}
फ़ील्ड
surfaceType

enum (ContextType)

सिर्फ़ आउटपुट के लिए. असाइन किया गया यह टास्क किस प्लैटफ़ॉर्म से शुरू हुआ है. फ़िलहाल, यह सुविधा सिर्फ़ दस्तावेज़ या स्पेस के लिए उपलब्ध है.
यूनियन फ़ील्ड surface_info. उस प्लैटफ़ॉर्म (Docs, Chat स्पेस) की जानकारी जहां से यह टास्क असाइन किया गया था. surface_info इनमें से कोई एक हो सकता है:
driveResourceInfo

object (DriveResourceInfo)

सिर्फ़ आउटपुट के लिए. उस Drive फ़ाइल के बारे में जानकारी जहां से यह टास्क शुरू हुआ. फ़िलहाल, Drive फ़ाइल सिर्फ़ दस्तावेज़ हो सकती है. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.
spaceInfo

object (SpaceInfo)

सिर्फ़ आउटपुट के लिए. उस चैट स्पेस की जानकारी जहां से यह टास्क शुरू हुआ था. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.

ContextType

टास्क से जुड़ा प्रॉडक्ट.

Enums
CONTEXT_TYPE_UNSPECIFIED इस टास्क के कॉन्टेक्स्ट के लिए अज्ञात वैल्यू.
GMAIL टास्क, Gmail से बनाया गया हो.
DOCUMENT टास्क किसी दस्तावेज़ से असाइन किया गया हो.
SPACE टास्क को चैट स्पेस से असाइन किया गया हो.

DriveResourceInfo

उस Drive संसाधन के बारे में जानकारी जहां से टास्क असाइन किया गया था (दस्तावेज़, शीट वगैरह).

JSON के काेड में दिखाना 
{
  "driveFileId": string,
  "resourceKey": string
}
फ़ील्ड
driveFileId

string

सिर्फ़ आउटपुट के लिए. Drive API में फ़ाइल का आइडेंटिफ़ायर.
resourceKey

string

सिर्फ़ आउटपुट के लिए. शेयर किए गए लिंक से शेयर की गई फ़ाइलों को ऐक्सेस करने के लिए ज़रूरी संसाधन कुंजी. सभी फ़ाइलों के लिए ज़रूरी नहीं है. developers.google.com/drive/api/guides/resource-keys भी देखें.

SpaceInfo

उस चैट स्पेस की जानकारी जहां से टास्क असाइन किया गया था.

JSON के काेड में दिखाना 
{
  "space": string
}
फ़ील्ड
space

string

सिर्फ़ आउटपुट के लिए. वह चैट स्पेस जहां से यह टास्क शुरू हुआ था. इसका फ़ॉर्मैट "spaces/{space}" है.

तरीके

clear

 यह सुविधा, चुनी गई टास्क सूची से पूरे हो चुके सभी टास्क मिटा देती है.

delete

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

get

 तय किया गया टास्क दिखाता है.

insert

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

list

 यह फ़ंक्शन, किसी टास्क की सूची में मौजूद सभी टास्क दिखाता है.

move

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

patch

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

update

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