Method: drives.list

यह उपयोगकर्ता की शेयर की गई ड्राइव की सूची बनाता है.

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

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

GET https://www.googleapis.com/drive/v3/drives

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

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

पैरामीटर
pageSize

integer

हर पेज पर वापस आने के लिए, शेयर की गई ड्राइव की ज़्यादा से ज़्यादा संख्या.

pageToken

string

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

q

string

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

useDomainAdminAccess

boolean

डोमेन एडमिन के तौर पर अनुरोध जारी करें; अगर नीति को 'सही है' पर सेट किया जाता है, तो उस डोमेन की शेयर की गई वे सभी ड्राइव दिखेंगी जिनका अनुरोध करने वाला व्यक्ति एडमिन है.

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

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

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

शेयर की गई ड्राइव की सूची.

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

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

string

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

kind

string

इससे पता चलता है कि यह किस तरह का संसाधन है. वैल्यू: तय स्ट्रिंग "drive#driveList".

drives[]

object (Drive)

शेयर की गई ड्राइव की सूची. अगर NextPageToken में जानकारी अपने-आप भर जाती है, तो हो सकता है कि यह सूची अधूरी हो और नतीजों का एक और पेज फ़ेच किया जाना चाहिए.

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly

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