Method: tasks.list

यह फ़ंक्शन, किसी टास्क की सूची में मौजूद सभी टास्क दिखाता है. डिफ़ॉल्ट रूप से, असाइन किए गए टास्क नहीं दिखाता (Docs और चैट स्पेस से). किसी उपयोगकर्ता के पास हर सूची में, छिपे हुए नहीं होने वाले 20,000 टास्क हो सकते हैं. साथ ही, एक बार में कुल 1,00,000 टास्क हो सकते हैं.

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

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

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

पाथ पैरामीटर

पैरामीटर
tasklist

string

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

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

पैरामीटर
completedMax

string

टास्क पूरा होने की तारीख (RFC 3339 टाइमस्टैंप के तौर पर) की ऊपरी सीमा, ताकि फ़िल्टर किया जा सके. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, पूरा होने की तारीख के हिसाब से फ़िल्टर नहीं किया जाता.
completedMin

string

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

string

टास्क की समयसीमा खत्म होने की तारीख (RFC 3339 टाइमस्टैंप के तौर पर) की ऊपरी सीमा, ताकि फ़िल्टर किया जा सके. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, टास्क की समयसीमा के हिसाब से फ़िल्टर नहीं किया जाता.
dueMin

string

टास्क के पूरा होने की तारीख (RFC 3339 टाइमस्टैंप के तौर पर) की निचली सीमा, ताकि फ़िल्टर किया जा सके. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, टास्क की समयसीमा के हिसाब से फ़िल्टर नहीं किया जाता.
maxResults

integer

एक पेज पर दिखाए जाने वाले टास्क की ज़्यादा से ज़्यादा संख्या. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह संख्या 20 होती है. हालांकि, ज़्यादा से ज़्यादा 100 सदस्य जोड़े जा सकते हैं.
pageToken

string

नतीजों वाले पेज की जानकारी देने वाला टोकन. ज़रूरी नहीं.
showCompleted

boolean

इस फ़्लैग से पता चलता है कि नतीजों में पूरे हो चुके टास्क दिखाए जाते हैं या नहीं. ध्यान दें कि फ़र्स्ट पार्टी क्लाइंट में पूरे हो चुके टास्क दिखाने के लिए, showHidden की वैल्यू भी True होनी चाहिए. जैसे, वेब यूज़र इंटरफ़ेस (यूआई) और Google के मोबाइल ऐप्लिकेशन. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'सही' पर सेट होता है.
showDeleted

boolean

फ़्लैग से पता चलता है कि नतीजों में मिटाए गए टास्क दिखाए जाते हैं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है.
showHidden

boolean

यह फ़्लैग बताता है कि नतीजों में छिपे हुए टास्क दिखाए जाते हैं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है.
updatedMin

string

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

boolean

ज़रूरी नहीं. इस फ़्लैग से पता चलता है कि मौजूदा उपयोगकर्ता को असाइन किए गए टास्क, नतीजों में दिखाए जाते हैं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है.

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

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

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
फ़ील्ड
kind

string

संसाधन का टाइप. यह हमेशा "tasks#tasks" होता है.
etag

string

संसाधन का ETag.
nextPageToken

string

इस नतीजे के अगले पेज को ऐक्सेस करने के लिए इस्तेमाल किया जाने वाला टोकन.
items[]

object (Task)

टास्क का कलेक्शन.

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

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

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

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

Tasks

JSON के काेड में दिखाना 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
फ़ील्ड
kind

string

संसाधन का टाइप. यह हमेशा "tasks#tasks" होता है.
etag

string

संसाधन का ETag.
nextPageToken

string

इस नतीजे के अगले पेज को ऐक्सेस करने के लिए इस्तेमाल किया जाने वाला टोकन.
items[]

object (Task)

टास्क का कलेक्शन.