Method: children.list

किसी फ़ोल्डर के चाइल्ड फ़ोल्डर की सूची बनाता है.

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

GET https://www.googleapis.com/drive/v2/files/{folderId}/children

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

पाथ पैरामीटर

पैरामीटर
folderId

string

फ़ोल्डर का आईडी.

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

पैरामीटर
maxResults

integer

लौटाए जाने वाले बच्चों की ज़्यादा से ज़्यादा संख्या.
orderBy

string

कॉमा लगाकर अलग की गई, क्रम से लगाने की कुंजियों की सूची. मान्य कुंजियां: createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred, और title. हर बटन, डिफ़ॉल्ट रूप से बढ़ते क्रम में क्रम से लगाता है. हालांकि, desc बटन का इस्तेमाल करके, क्रम को घटते क्रम में भी लगाया जा सकता है. इस्तेमाल का उदाहरण: ?orderBy=folder,modifiedDate desc,title. कृपया ध्यान दें कि फ़िलहाल, जिन उपयोगकर्ताओं के पास करीब एक करोड़ फ़ाइलें हैं उनके लिए, फ़ाइलों को क्रम से लगाने का अनुरोध करने पर, उस अनुरोध को अनदेखा कर दिया जाता है.
pageToken

string

बच्चों के लिए पेज टोकन.
q

string

बच्चों को खोजने के लिए क्वेरी स्ट्रिंग.

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

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

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

किसी फ़ाइल के चाइल्ड एलिमेंट की सूची.

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

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

string

बच्चों के अगले पेज का पेज टोकन. अगर बच्चों की सूची खत्म हो गई है, तो यह विकल्प नहीं दिखेगा. अगर किसी वजह से टोकन अस्वीकार कर दिया जाता है, तो उसे खारिज कर दिया जाना चाहिए. साथ ही, नतीजों के पहले पेज से पेजेशन को फिर से शुरू किया जाना चाहिए.
kind

string

यह हमेशा drive#childList होती है.
etag

string

सूची का ETag.
items[]

object (ChildReference)

बच्चों की सूची. अगर nextPageToken की वैल्यू मौजूद है, तो हो सकता है कि यह सूची पूरी न हो. ऐसे में, नतीजों का एक और पेज फ़ेच किया जाना चाहिए.

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

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

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

कुछ स्कोप पर पाबंदी होती है. साथ ही, इनका इस्तेमाल करने के लिए आपके ऐप्लिकेशन को सुरक्षा से जुड़ी समीक्षा कराने की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.