- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
यह उपयोगकर्ता की शेयर की गई ड्राइव की सूची बनाता है.
इस तरीके से q
पैरामीटर स्वीकार किया जाता है. यह ऐसी खोज क्वेरी है जिसमें खोज के लिए इस्तेमाल हुए एक या उससे ज़्यादा शब्दों को शामिल किया जाता है. ज़्यादा जानकारी के लिए, शेयर की गई ड्राइव खोजना गाइड देखें.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v3/drives
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSize |
हर पेज पर वापस आने के लिए, शेयर की गई ड्राइव की ज़्यादा से ज़्यादा संख्या. |
pageToken |
शेयर की गई ड्राइव के लिए पेज टोकन. |
q |
शेयर की गई ड्राइव खोजने के लिए क्वेरी स्ट्रिंग. |
useDomainAdminAccess |
डोमेन एडमिन के तौर पर अनुरोध जारी करें; अगर नीति को 'सही है' पर सेट किया जाता है, तो उस डोमेन की शेयर की गई वे सभी ड्राइव दिखेंगी जिनका अनुरोध करने वाला व्यक्ति एडमिन है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
शेयर की गई ड्राइव की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"nextPageToken": string,
"kind": string,
"drives": [
{
object ( |
फ़ील्ड | |
---|---|
nextPageToken |
शेयर की गई ड्राइव के अगले पेज के लिए पेज टोकन. अगर सूची खत्म हो जाती है, तो यह संख्या मौजूद नहीं होगी. अगर टोकन किसी वजह से अस्वीकार हो जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, नतीजों के पहले पेज से पेज नंबर डालना फिर से शुरू करना चाहिए. आम तौर पर, पेज टोकन कई घंटों के लिए मान्य होता है. हालांकि, अगर नए आइटम जोड़े या हटाए जाते हैं, तो आपको अलग तरह के नतीजे दिख सकते हैं. |
kind |
इससे पता चलता है कि यह किस तरह का संसाधन है. वैल्यू: तय स्ट्रिंग |
drives[] |
शेयर की गई ड्राइव की सूची. अगर NextPageToken में जानकारी अपने-आप भर जाती है, तो हो सकता है कि यह सूची अधूरी हो और नतीजों का एक और पेज फ़ेच किया जाना चाहिए. |
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
कुछ दायरे पर पाबंदी है. इनका इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.