इस दस्तावेज़ में, फ़ाइलों को नाम देने और इंडेक्स किए जा सकने वाले टेक्स्ट और थंबनेल जैसे मेटाडेटा के साथ काम करने के बारे में अहम जानकारी दी गई है. फ़ाइलें डालने और वापस पाने के लिए, 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)