Method: drives.list

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

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

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

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

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

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

पैरामीटर
pageSize

integer

शेयर की गई ज़्यादा से ज़्यादा ड्राइव की संख्या. सेवा, इस वैल्यू से कम ड्राइव दिखा सकती है.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10 शेयर की गई ड्राइव दिखाई जाएंगी.

इसकी ज़्यादा से ज़्यादा वैल्यू 100 है. 100 से ज़्यादा वैल्यू को 100 में बदल दिया जाएगा.
pageToken

string

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

string

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

boolean

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

अनुरोध का मुख्य हिस्सा

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

जवाब का मुख्य हिस्सा

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

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "drives": [
    {
      object (Drive)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
फ़ील्ड
drives[]

object (Drive)

शेयर की गई ड्राइव की सूची. अगर nextPageToken की वैल्यू मौजूद है, तो हो सकता है कि यह सूची पूरी न हो. इसलिए, नतीजों का एक और पेज फ़ेच किया जाना चाहिए.
nextPageToken

string

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

string

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

अनुमति पाने के लिंक

इसके लिए, OAuth की इनमें से किसी एक अनुमति की ज़रूरत होती है:

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

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