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 के काेड में दिखाना 
{
  "items": [
    {
      object (ChildReference)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string
}
फ़ील्ड
items[]

object (ChildReference)

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

string

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

string

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

string

सूची का ETag.

अनुमति के स्कोप

इसके लिए, इनमें से किसी एक 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

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