- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- कॉर्पस
- इसे आज़माएं!
उपयोगकर्ता की फ़ाइलों की सूची बनाता है.
यह तरीका q
पैरामीटर को स्वीकार करता है. यह एक ऐसी खोज क्वेरी है जिसमें एक या उससे ज़्यादा खोज शब्दों को मिलाया जाता है. ज़्यादा जानकारी के लिए, फ़ाइलें और फ़ोल्डर खोजें गाइड देखें.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v2/files
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
corpora |
आइटम (फ़ाइलें या दस्तावेज़) जिन पर क्वेरी लागू होती है. |
corpus |
अब काम नहीं करता: आइटम का वह मुख्य हिस्सा (फ़ाइलें/दस्तावेज़) जिन पर क्वेरी लागू होती है. इसके बजाय, |
driveId |
खोजने के लिए शेयर की गई ड्राइव का आईडी. |
includeItemsFromAllDrives |
नतीजों में, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव' के आइटम, दोनों शामिल किए जाने चाहिए या नहीं. |
includeTeamDriveItems |
अब सेवा में नहीं है: इसके बजाय |
maxResults |
हर पेज पर लौटाने के लिए फ़ाइलों की ज़्यादा से ज़्यादा संख्या. फ़ाइलों की सूची खत्म होने से पहले ही, नतीजों वाले पेजों के कुछ हिस्से या खाली हो सकते हैं. |
orderBy |
क्रम से लगाने वाली कुंजियों की कॉमा-सेपरेटेड लिस्ट. मान्य कुंजियां हैं |
pageToken |
फ़ाइलों के लिए पेज टोकन. |
projection |
अब काम नहीं करता: इस पैरामीटर में कोई फ़ंक्शन नहीं है. |
q |
फ़ाइलें खोजने के लिए क्वेरी स्ट्रिंग. |
spaces |
क्वेरी करने के लिए स्पेस की कॉमा-सेपरेटेड लिस्ट. |
supportsAllDrives |
अनुरोध किया गया ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं. |
supportsTeamDrives |
अब सेवा में नहीं है: इसके बजाय |
teamDriveId |
अब सेवा में नहीं है: इसके बजाय |
includePermissionsForView |
इससे पता चलता है कि जवाब में कौनसे अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. वैल्यू के तौर पर, सिर्फ़ |
includeLabels |
जवाब के |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
फ़ाइलों की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
फ़ील्ड | |
---|---|
nextPageToken |
फ़ाइलों के अगले पेज के लिए पेज टोकन. अगर फ़ाइलों की सूची का आखिरी एलिमेंट खत्म हो गया है, तो यह फ़ाइल नहीं दिखेगी. अगर किसी वजह से टोकन अस्वीकार किया जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, नतीजों के पहले पेज से ही पेज नंबर को फिर से शुरू करना चाहिए. |
kind |
यह हमेशा |
etag |
सूची का ETag. |
selfLink |
इस सूची पर वापस जाने के लिए लिंक. |
incompleteSearch |
क्या खोज की प्रोसेस अधूरी थी. अगर यह वैल्यू सही है, तो हो सकता है कि कुछ खोज नतीजे मौजूद न हों, क्योंकि सभी दस्तावेज़ नहीं खोजे गए थे. "allDrive" कॉर्पस वाली कई ड्राइव में खोजने पर ऐसा हो सकता है, लेकिन सभी कॉर्पस को नहीं खोजा जा सका. ऐसा होने पर, क्लाइंट को "डिफ़ॉल्ट" या "ड्राइव" जैसे किसी दूसरे कलेक्शन को चुनकर, अपनी क्वेरी को छोटा करने का सुझाव दिया जाता है. |
nextLink |
फ़ाइलों के अगले पेज का लिंक. |
items[] |
फ़ाइलों की सूची. अगर NextPageToken को पॉप्युलेट किया जाता है, तो यह सूची अधूरी हो सकती है. साथ ही, नतीजों का एक और पेज फ़ेच किया जाना चाहिए. |
अनुमति देने के दायरे
इनमें से कोई एक OAuth स्कोप ज़रूरी है:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
कुछ दायरे सीमित हैं. इनका इस्तेमाल करने के लिए, सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.
कॉर्पस
Enums | |
---|---|
DEFAULT |
वे आइटम जिन्हें उपयोगकर्ता ने ऐक्सेस किया है. |
DOMAIN |
उपयोगकर्ता के डोमेन में शेयर किए गए आइटम. |