Method: drives.list

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

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

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

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

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

q

string

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

useDomainAdminAccess

boolean

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

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

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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

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