Google Drive API की मदद से, फ़ाइलों और फ़ोल्डर को कई तरीकों से खोजा जा सकता है.
Drive के किसी उपयोगकर्ता की सभी या कुछ फ़ाइलों और फ़ोल्डर को वापस लाने के लिए, files.list
तरीके का इस्तेमाल किया जा सकता है. files.list
तरीका का इस्तेमाल, कुछ संसाधन के तरीकों (जैसे, files.get
और
files.update
) के लिए ज़रूरी fileId
को वापस पाने के लिए भी किया जा सकता है.
मौजूदा उपयोगकर्ता के 'मेरी ड्राइव' में मौजूद सभी फ़ाइलें और फ़ोल्डर खोजना
सभी फ़ाइलों और फ़ोल्डर को दिखाने के लिए, किसी भी पैरामीटर के बिना files.list
तरीके का इस्तेमाल करें.
GET https://www.googleapis.com/drive/v3/files
मौजूदा उपयोगकर्ता के 'मेरी ड्राइव' में मौजूद चुनिंदा फ़ाइलें या फ़ोल्डर खोजना
फ़ाइलों या फ़ोल्डर के किसी खास सेट को खोजने के लिए, क्वेरी स्ट्रिंग q
फ़ील्ड का इस्तेमाल करें. साथ ही, files.list
तरीके से फ़ाइलों को फ़िल्टर करें. ऐसा करने के लिए, एक या उससे ज़्यादा खोज शब्दों को जोड़ें.
क्वेरी स्ट्रिंग में ये तीन हिस्से होते हैं:
query_term operator values
कहां:
query_term
वह क्वेरी या फ़ील्ड है जिस पर खोज करनी है.operator
, क्वेरी के लिए शर्त तय करता है.values
वे खास वैल्यू होती हैं जिनका इस्तेमाल करके, आपको खोज के नतीजों को फ़िल्टर करना है.
फ़ाइलों और फ़ोल्डर को फ़िल्टर करने के लिए, क्वेरी के शब्द और ऑपरेटर देखें. इसके लिए, खोज क्वेरी के शब्द और ऑपरेटर लेख पढ़ें.
उदाहरण के लिए, नीचे दी गई क्वेरी स्ट्रिंग, MIME टाइप सेट करके खोज को फ़िल्टर करती है, ताकि सिर्फ़ फ़ोल्डर दिखें:
q: mimeType = 'application/vnd.google-apps.folder'
एमआईएम टाइप के बारे में ज़्यादा जानने के लिए, Google Workspace और Google Drive में काम करने वाले एमआईएम टाइप लेख पढ़ें.
क्वेरी स्ट्रिंग के उदाहरण
यहां दी गई टेबल में, कुछ बुनियादी क्वेरी स्ट्रिंग के उदाहरण दिए गए हैं. असल कोड, खोज के लिए इस्तेमाल की जाने वाली क्लाइंट लाइब्रेरी के हिसाब से अलग-अलग होता है.
आपको अपनी फ़ाइल के नामों में भी खास वर्णों को मार्क करना होगा, ताकि यह पक्का किया जा सके कि क्वेरी सही तरीके से काम करे. उदाहरण के लिए, अगर फ़ाइल के नाम में ऐपोस्ट्रॉफ़ ('
) और बैकस्लैश ("\"
) वर्ण, दोनों शामिल हैं, तो उन्हें एस्केप करने के लिए बैकस्लैश का इस्तेमाल करें: name
contains 'quinn\'s paper\\essay'
.
आपको किस बारे में क्वेरी करनी है | उदाहरण |
---|---|
"hello" नाम वाली फ़ाइलें | name = 'hello' |
जिन फ़ाइलों के नाम में "नमस्ते" और "अलविदा" शब्द शामिल हों | name contains 'hello' and name contains 'goodbye' |
जिन फ़ाइलों के नाम में "hello" शब्द शामिल नहीं है | not name contains 'hello' |
ऐसी फ़ाइलें जिनमें "ज़रूरी" टेक्स्ट है और जो ट्रैश में हैं | fullText contains 'important' and trashed = true |
ऐसी फ़ाइलें जिनमें "नमस्ते" शब्द है | fullText contains 'hello' |
ऐसी फ़ाइलें जिनमें "नमस्ते" शब्द मौजूद नहीं है | not fullText contains 'hello' |
ऐसी फ़ाइलें जिनमें "hello world" वाक्यांश पूरी तरह शामिल हो | fullText contains '"hello world"' |
ऐसी फ़ाइलें जिनमें "\" वर्ण वाली क्वेरी शामिल है. उदाहरण के लिए, "\authors" | fullText contains '\\authors' |
फ़ोल्डर के तौर पर सेव की गई फ़ाइलें | mimeType = 'application/vnd.google-apps.folder' |
फ़ाइलें, जो फ़ोल्डर नहीं हैं | mimeType != 'application/vnd.google-apps.folder' |
किसी तारीख के बाद बदली गई फ़ाइलें (डिफ़ॉल्ट टाइम ज़ोन यूटीसी है) | modifiedTime > '2012-06-04T12:00:00' |
इमेज या वीडियो फ़ाइलों में किसी खास तारीख के बाद किए गए बदलाव | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
स्टार के निशान वाली फ़ाइलें | starred = true |
किसी कलेक्शन में मौजूद फ़ाइलें (उदाहरण के लिए, parents कलेक्शन में मौजूद फ़ोल्डर आईडी) |
'1234567' in parents |
किसी कलेक्शन में ऐप्लिकेशन डेटा फ़ोल्डर में मौजूद फ़ाइलें | 'appDataFolder' in parents |
ऐसी फ़ाइलें जिनका मालिकाना हक उपयोगकर्ता "test@example.org" के पास है | 'test@example.org' in owners |
ऐसी फ़ाइलें जिनमें उपयोगकर्ता "test@example.org" के पास लिखने की अनुमति है | 'test@example.org' in writers |
वे फ़ाइलें जिनमें "group@example.org" ग्रुप के सदस्यों के पास बदलाव करने की अनुमति है | 'group@example.org' in writers |
अनुमति वाले उपयोगकर्ता के साथ शेयर की गई ऐसी फ़ाइलें जिनके नाम में "hello" है | sharedWithMe and name contains 'hello' |
सभी ऐप्लिकेशन को दिखने वाली, कस्टम फ़ाइल प्रॉपर्टी वाली फ़ाइलें | properties has { key='mass' and value='1.3kg' } |
अनुरोध करने वाले ऐप्लिकेशन के लिए निजी, कस्टम फ़ाइल प्रॉपर्टी वाली फ़ाइलें | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
ऐसी फ़ाइलें जिन्हें किसी के साथ या किसी डोमेन के साथ शेयर नहीं किया गया है. ये फ़ाइलें सिर्फ़ निजी होती हैं या किसी खास उपयोगकर्ता या ग्रुप के साथ शेयर की जाती हैं | visibility = 'limited' |
क्लाइंट लाइब्रेरी की मदद से खोज के नतीजे फ़िल्टर करना
यहां दिए गए कोड सैंपल में, क्लाइंट लाइब्रेरी का इस्तेमाल करके, खोज के नतीजों को JPEG फ़ाइलों के नाम और आईडी के हिसाब से फ़िल्टर करने का तरीका बताया गया है. इस सैंपल में, mimeType
क्वेरी शब्द का इस्तेमाल करके, नतीजों को image/jpeg
टाइप की फ़ाइलों तक सीमित किया गया है. यह Drive के स्टोरेज में खोज के नतीजों को सीमित करने के लिए, spaces
को drive
पर भी सेट करता है. जब nextPageToken
null
दिखाता है, तो इसका मतलब है कि कोई और नतीजा नहीं है.
Java
Python
Node.js
PHP
कस्टम फ़ाइल प्रॉपर्टी वाली फ़ाइलें खोजना
कस्टम फ़ाइल प्रॉपर्टी वाली फ़ाइलें खोजने के लिए, properties
या appProperties
खोज क्वेरी के साथ कीवर्ड और वैल्यू का इस्तेमाल करें. उदाहरण के लिए, 8e8aceg2af2ge72e78
की वैल्यू वाली, additionalID
नाम के अनुरोध करने वाले ऐप्लिकेशन के लिए निजी, कस्टम फ़ाइल प्रॉपर्टी खोजने के लिए:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
ज़्यादा जानकारी के लिए, पसंद के मुताबिक फ़ाइल प्रॉपर्टी जोड़ना लेख पढ़ें.
किसी खास लेबल या फ़ील्ड वैल्यू वाली फ़ाइलें खोजना
किसी खास लेबल वाली फ़ाइलें खोजने के लिए, किसी खास लेबल आईडी के साथ labels
खोज क्वेरी शब्द का इस्तेमाल करें. उदाहरण के लिए: 'labels/LABEL_ID' in
labels
. अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में वे सभी फ़ाइल इंस्टेंस शामिल होते हैं जिन पर लेबल लागू किया गया है.
किसी खास लेबल आईडी के बिना फ़ाइलें खोजने के लिए: Not
'labels/LABEL_ID' in labels
.
फ़ील्ड की खास वैल्यू के आधार पर भी फ़ाइलें खोजी जा सकती हैं. उदाहरण के लिए, टेक्स्ट वैल्यू वाली फ़ाइलें खोजने के लिए:
labels/LABEL_ID.text_field_id ='TEXT'
.
ज़्यादा जानकारी के लिए, किसी खास लेबल या फ़ील्ड वैल्यू वाली फ़ाइलें खोजना लेख पढ़ें.
कॉर्पस खोजना
files.list
को कॉल करने वाली खोजें, डिफ़ॉल्ट रूप से user
के corpora
का इस्तेमाल करती हैं. domain
के साथ शेयर की गई फ़ाइलों जैसी अन्य कॉर्पोरा खोजने के लिए, corpora
पैरामीटर सेट करें.
एक ही क्वेरी में कई कॉर्पस खोजे जा सकते हैं. हालांकि, अगर कॉर्पस का साइज़ बहुत बड़ा है, तो अधूरे नतीजे दिख सकते हैं. अगर रिस्पॉन्स बॉडी में incompleteSearch
true
है, तो इसका मतलब है कि सभी दस्तावेज़ नहीं दिखाए गए हैं. अगर ऐसा होता है, तो आपको अपनी क्वेरी को छोटा करना चाहिए. इसके लिए, user
या drive
जैसे किसी दूसरे कॉर्पोरेशन को चुनें.
मिलते-जुलते विषय
- शेयर की गई ड्राइव खोजना
- सर्च क्वेरी के लिए शब्द और ऑपरेटर
- Google Workspace और Google Drive के साथ काम करने वाले एमआईई टाइप
- भूमिकाएं और अनुमतियां
- किसी खास लेबल या फ़ील्ड वैल्यू वाली फ़ाइलें खोजना