Method: tasks.list

बताई गई टास्क सूची के सभी टास्क दिखाता है. किसी उपयोगकर्ता के पास, हर सूची में ज़्यादा से ज़्यादा 20,000 ऐसे टास्क हो सकते हैं जिन्हें छिपाया नहीं गया है. साथ ही, एक बार में कुल 1,00,000 टास्क बनाए जा सकते हैं.

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

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

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

पाथ के पैरामीटर

पैरामीटर
tasklist

string

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

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

पैरामीटर
completedMax

string

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

completedMin

string

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

dueMax

string

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

dueMin

string

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

maxResults

integer

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

pageToken

string

यह टोकन, उस पेज को दिखाता है जिसे दिखाना है. ज़रूरी नहीं.

showCompleted

boolean

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

showDeleted

boolean

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

showHidden

boolean

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

updatedMin

string

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

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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

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

टास्क

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

string

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

etag

string

संसाधन का ETag.

nextPageToken

string

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

items[]

object (Task)

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