Method: drives.list

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

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

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

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

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

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

पैरामीटर
pageSize

integer

हर पेज पर शेयर की गई ड्राइव की ज़्यादा से ज़्यादा संख्या.
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

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