Method: drives.list

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

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

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

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

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

q

string

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

useDomainAdminAccess

boolean

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

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

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

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

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

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

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

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