- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- इसे आज़माएं!
उपयोगकर्ता की शेयर की गई ड्राइव की सूची दिखाता है.
यह तरीका q
पैरामीटर को स्वीकार करता है. यह एक या उससे ज़्यादा खोज के लिए इस्तेमाल हुए शब्दों को जोड़ने वाली खोज क्वेरी होती है. ज़्यादा जानकारी के लिए, शेयर की गई ड्राइव खोजना गाइड देखें.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v3/drives
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSize |
हर पेज पर, शेयर की गई ड्राइव की ज़्यादा से ज़्यादा संख्या. |
pageToken |
शेयर की गई ड्राइव के लिए पेज टोकन. |
q |
शेयर की गई ड्राइव खोजने के लिए क्वेरी स्ट्रिंग. |
useDomainAdminAccess |
डोमेन एडमिन के तौर पर अनुरोध करें. अगर इस पैरामीटर को 'सही है' पर सेट किया जाता है, तो उस डोमेन की सभी शेयर की गई ड्राइव दिखती हैं जिसमें अनुरोध करने वाला व्यक्ति एडमिन है. अगर इसे 'गलत है' (डिफ़ॉल्ट) पर सेट किया जाता है, तो ज़्यादा से ज़्यादा 1,000 रिकॉर्ड दिखाए जाते हैं. भले ही, ज़्यादा रिकॉर्ड मौजूद हों. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
शेयर की गई ड्राइव की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
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
कुछ स्कोप पर पाबंदी होती है. साथ ही, इनका इस्तेमाल करने के लिए आपके ऐप्लिकेशन को सुरक्षा से जुड़ी समीक्षा कराने की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.