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

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

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