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=फ़ोल्डर,modifiedDate Description,title. कृपया ध्यान दें कि ऐसे उपयोगकर्ताओं पर मौजूदा सीमा लागू होती है जिनके पास करीब 10 लाख फ़ाइलें हैं. ऐसे उपयोगकर्ताओं के लिए, क्रम से लगाने के अनुरोध को अनदेखा किया जाता है.

pageToken

string

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

q

string

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

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

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

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

किसी फ़ाइल के चिल्ड्रेन की सूची.

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

जेएसओएन के काेड में दिखाना
{
  "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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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