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

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

string

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

string

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

string

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

string

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

string

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

boolean

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

boolean

इस फ़्लैग से पता चलता है कि टास्क छिपा हुआ है या नहीं. ऐसा तब होता है, जब टास्क लिस्ट को आखिरी बार मिटाते समय टास्क को 'पूरा हो गया' के तौर पर मार्क किया गया हो. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. इस फ़ील्ड में मौजूद डेटा को सिर्फ़ पढ़ा जा सकता है.
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)

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

object (DriveResourceInfo)

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

object (SpaceInfo)

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

ContextType

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

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

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

सिर्फ़ आउटपुट के लिए. यह टास्क जिस Chat स्पेस से बनाया गया है. इसका फ़ॉर्मैट "spaces/{space}" होता है.

तरीके

clear

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

delete

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

get

 इससे, तय किया गया टास्क मिलता है.

insert

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

list

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

move

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

patch

 इससे चुने गए टास्क को अपडेट किया जाता है.

update

 इससे चुने गए टास्क को अपडेट किया जाता है.