इस दस्तावेज़ में फ़ाइलों को नाम देने और इंडेक्स किए जा सकने वाले टेक्स्ट और थंबनेल जैसे मेटाडेटा के साथ काम करने से जुड़ी ज़रूरी बातें बताई गई हैं. फ़ाइलें शामिल करने और वापस लाने के लिए, files संसाधन देखें.
फ़ाइल के नाम और एक्सटेंशन डालें
Google Drive API का इस्तेमाल करके फ़ाइलें शामिल करते समय, ऐप्लिकेशन को टाइटल प्रॉपर्टी में एक फ़ाइल एक्सटेंशन तय करना चाहिए. उदाहरण के लिए, JPEG फ़ाइल शामिल करने की कार्रवाई के मेटाडेटा में "name": "cat.jpg" जैसी जानकारी होनी चाहिए.
इसके बाद के GET रिस्पॉन्स में, रीड-ओनली fileExtension प्रॉपर्टी शामिल हो सकती है. इसमें name प्रॉपर्टी में मूल रूप से बताए गए एक्सटेंशन की जानकारी होती है. जब कोई Google Drive उपयोगकर्ता किसी फ़ाइल को डाउनलोड करने का अनुरोध करता है या सिंक क्लाइंट की मदद से फ़ाइल डाउनलोड की जाती है, तो Drive टाइटल के आधार पर फ़ाइल का पूरा नाम (एक्सटेंशन के साथ) बनाता है. अगर फ़ाइल में एक्सटेंशन नहीं है, तो Drive, फ़ाइल के एमआईएम टाइप के आधार पर एक्सटेंशन का पता लगाने की कोशिश करता है.
इंडेक्स किया जा सकने वाला टेक्स्ट सेव करना
Drive, फ़ाइल टाइप की पहचान करने के बाद, खोज के लिए दस्तावेज़ों को अपने-आप इंडेक्स करता है. इनमें टेक्स्ट दस्तावेज़, PDF, टेक्स्ट वाली इमेज, और अन्य सामान्य टाइप के दस्तावेज़ शामिल हैं. अगर आपका ऐप्लिकेशन ड्रॉइंग, वीडियो, और शॉर्टकट जैसी अन्य फ़ाइलें सेव करता है, तो फ़ाइल के contentHints.indexableText फ़ील्ड में इंडेक्स किया जा सकने वाला टेक्स्ट डालकर, फ़ाइल को खोजने लायक बनाया जा सकता है.
इंडेक्स किए जा सकने वाले टेक्स्ट को एचटीएमएल के तौर पर इंडेक्स किया जाता है. अगर इंडेक्स की जा सकने वाली टेक्स्ट स्ट्रिंग <section attribute="value1">Here's some text</section> सेव की जाती है, तो "यहां कुछ टेक्स्ट है" को इंडेक्स किया जाता है, लेकिन "value1" को नहीं. इस वजह से, इंडेक्स किए जा सकने वाले टेक्स्ट के तौर पर एक्सएमएल को सेव करना, एचटीएमएल को सेव करने के बराबर फ़ायदेमंद नहीं है.
indexableText के बारे में बताते समय, इन बातों का भी ध्यान रखें:
contentHints.indexableTextका साइज़ 128 केबी से ज़्यादा नहीं होना चाहिए.- उन मुख्य शब्दों और कॉन्सेप्ट को कैप्चर करें जिन्हें आपके हिसाब से उपयोगकर्ता खोज सकता है.
- टेक्स्ट को अहमियत के हिसाब से क्रम में लगाने की कोशिश न करें, क्योंकि इंडेक्सर आपके लिए यह काम बेहतर तरीके से करता है.
- आपके ऐप्लिकेशन को हर सेव करने पर, इंडेक्स किए जा सकने वाले टेक्स्ट को अपडेट करना चाहिए.
- पक्का करें कि टेक्स्ट, फ़ाइल के कॉन्टेंट या मेटाडेटा से जुड़ा हो.
यह आखिरी बात शायद आपको साफ़ तौर पर पता हो, लेकिन यह ज़रूरी है. खोज के नतीजों में किसी फ़ाइल को दिखाने के लिए, अक्सर खोजे जाने वाले शब्दों को जोड़ना अच्छा नहीं है. इससे उपयोगकर्ता परेशान हो सकते हैं और उन्हें फ़ाइल मिटाने के लिए भी बढ़ावा मिल सकता है.
थंबनेल अपलोड करना
Drive, कई सामान्य फ़ाइल टाइप के लिए अपने-आप थंबनेल जनरेट करता है. जैसे, Google Docs, Sheets, और Slides. थंबनेल की मदद से, उपयोगकर्ता Drive में मौजूद फ़ाइलों की पहचान बेहतर तरीके से कर पाते हैं.
जिन फ़ाइल टाइप के लिए Drive स्टैंडर्ड थंबनेल जनरेट नहीं कर पाता, उनके लिए आपके ऐप्लिकेशन से जनरेट की गई थंबनेल इमेज दी जा सकती है. फ़ाइल बनाते या अपडेट करते समय, files संसाधन पर contentHints.thumbnail फ़ील्ड सेट करके थंबनेल अपलोड करें.
खास तौर पर:
contentHints.thumbnail.imageफ़ील्ड को यूआरएल और फ़ाइल के नाम के तौर पर, सुरक्षित base64 कोड में बदली गई इमेज पर सेट करें. ज़्यादा जानकारी के लिए, आरएफ़सी 4648 सेक्शन 5 देखें.- थंबनेल के लिए,
contentHints.thumbnail.mimeTypeफ़ील्ड को सही MIME टाइप पर सेट करें.
अगर Drive, फ़ाइल से थंबनेल जनरेट कर सकता है, तो वह अपने-आप जनरेट हुए थंबनेल का इस्तेमाल करता है. साथ ही, अपलोड किए गए थंबनेल को अनदेखा कर देता है. अगर थंबनेल जनरेट नहीं हो पा रहा है, तो यह आपके दिए गए थंबनेल का इस्तेमाल करता है.
थंबनेल इन नियमों के मुताबिक होने चाहिए:
- इमेज को PNG, GIF या JPG फ़ॉर्मैट में अपलोड किया जा सकता है.
- सुझाई गई चौड़ाई 1600 पिक्सल है.
- कम से कम चौड़ाई 220 पिक्सल होनी चाहिए.
- फ़ाइल का साइज़ 2 एमबी से ज़्यादा नहीं होना चाहिए.
- उन्हें आपके ऐप्लिकेशन के हर सेव के साथ अपडेट किया जाना चाहिए.
ज़्यादा जानकारी के लिए, files रिसॉर्स देखें.
थंबनेल वापस पाना
Drive में मौजूद फ़ाइलों का मेटाडेटा वापस पाया जा सकता है. इसमें थंबनेल भी शामिल हैं.
थंबनेल की जानकारी, files संसाधन के thumbnailLink फ़ील्ड में मौजूद होती है.
कोई खास थंबनेल दिखाना
यहां दिए गए कोड सैंपल में, क्वेरी पैरामीटर के तौर पर कई फ़ील्ड वाला files.get तरीका अनुरोध दिखाया गया है. इससे किसी खास फ़ाइल के लिए thumbnailLink मेटाडेटा दिखाया जा सकता है. ज़्यादा जानकारी के लिए, किसी फ़ाइल के लिए खास फ़ील्ड दिखाना लेख पढ़ें.
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
FILE_ID की जगह उस फ़ाइल के fileId डालें जिसे आपको ढूंढना है.
उपलब्ध होने पर, अनुरोध फ़ाइल के थंबनेल का ऐसा यूआरएल वापस करता है जो कुछ समय के लिए उपलब्ध होता है.
आम तौर पर, यह लिंक कई घंटों तक काम करता है. यह फ़ील्ड सिर्फ़ तब भरता है, जब अनुरोध करने वाला ऐप्लिकेशन फ़ाइल का कॉन्टेंट ऐक्सेस कर सकता हो. अगर फ़ाइल को सार्वजनिक तौर पर शेयर नहीं किया गया है, तो thumbnailLink में लौटाए गए यूआरएल को क्रेडेंशियल वाले अनुरोध का इस्तेमाल करके, फ़ेच किया जाना चाहिए.
थंबनेल की सूची दिखाना
यहां दिए गए कोड के सैंपल में, क्वेरी पैरामीटर के तौर पर कई फ़ील्ड वाला files.list तरीका अनुरोध दिखाया गया है. इससे फ़ाइलों की सूची के लिए thumbnailLink मेटाडेटा वापस मिलता है. ज़्यादा जानकारी के लिए, फ़ाइलें और फ़ोल्डर खोजना लेख पढ़ें.
GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)
खोज के नतीजों को किसी खास फ़ाइल टाइप तक सीमित करने के लिए, क्वेरी स्ट्रिंग लागू करके MIME टाइप सेट करें. उदाहरण के लिए, नीचे दिए गए कोड सैंपल में, सूची को Google Sheets फ़ाइलों तक सीमित करने का तरीका बताया गया है. MIME टाइप के बारे में ज़्यादा जानकारी के लिए, Google Workspace और Google Drive पर काम करने वाले MIME टाइप देखें.
GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)