Method: files.list

उपयोगकर्ता की फ़ाइलों की सूची बनाता है.

इस तरीके से q पैरामीटर स्वीकार किया जाता है. यह ऐसी खोज क्वेरी है जिसमें खोज के लिए इस्तेमाल हुए एक या उससे ज़्यादा शब्दों को शामिल किया जाता है. ज़्यादा जानकारी के लिए, देखें फ़ाइलें और नाम खोजें फ़ोल्डर गाइड देखें.

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

GET https://www.googleapis.com/drive/v2/files

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

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

पैरामीटर
corpora

string

उन आइटम (फ़ाइलें/दस्तावेज़) के निकाय जिन पर क्वेरी लागू होती है. default, domain, drive, और allDrives का इस्तेमाल किया जा सकता है. बेहतर काम करने के लिए, allDrives के बजाय default या drive को प्राथमिकता दें.
corpus
(deprecated)

enum (Corpus)

बहिष्कृत: आइटम (फ़ाइलें/दस्तावेज़) का वह मुख्य भाग, जिस पर क्वेरी लागू होती है. इसके बजाय, corpora का इस्तेमाल करें.
driveId

string

खोजने के लिए शेयर की गई ड्राइव का आईडी.
includeItemsFromAllDrives

boolean

'मेरी ड्राइव' और 'शेयर की गई ड्राइव' के आइटम, दोनों को नतीजों में शामिल किया जाना चाहिए या नहीं.
includeTeamDriveItems
(deprecated)

boolean

अब काम नहीं करता: इसके बजाय, includeItemsFromAllDrives का इस्तेमाल करें.
maxResults

integer

प्रति पेज वापस दी जाने वाली फ़ाइलों की अधिकतम संख्या. फ़ाइलों की सूची खत्म होने से पहले भी नतीजे का कुछ हिस्सा या खाली पेज दिख सकता है.
orderBy

string

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

string

फ़ाइलों के लिए पेज टोकन.
projection
(deprecated)

enum (Projection)

अब काम नहीं करता: इस पैरामीटर का कोई फ़ंक्शन नहीं है.
q

string

फ़ाइलें खोजने के लिए क्वेरी स्ट्रिंग.
spaces

string

क्वेरी करने के लिए स्पेस की कॉमा-सेपरेटेड लिस्ट. drive और appDataFolder को वैल्यू के तौर पर इस्तेमाल किया जा सकता है.
supportsAllDrives

boolean

अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं.
supportsTeamDrives
(deprecated)

boolean

अब काम नहीं करता: इसके बजाय, supportsAllDrives का इस्तेमाल करें.
teamDriveId
(deprecated)

string

अब काम नहीं करता: इसके बजाय, driveId का इस्तेमाल करें.
includePermissionsForView

string

इससे पता चलता है कि रिस्पॉन्स में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ published का इस्तेमाल किया जा सकता है.
includeLabels

string

जवाब के labelInfo हिस्से में शामिल करने के लिए, लेबल के आईडी की कॉमा-सेपरेटेड लिस्ट.

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

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

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

फ़ाइलों की सूची.

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

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

string

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

string

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

string

सूची का ETag.
items[]

object (File)

फ़ाइलों की सूची. अगर 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.apps.readonly
  • 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

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

कॉर्पस

Enums
DEFAULT ऐसे आइटम जिन्हें उपयोगकर्ता ने ऐक्सेस किया है.
DOMAIN उपयोगकर्ता के डोमेन में शेयर किए गए आइटम.