इस दस्तावेज़ में फ़ाइलों को नाम देने और उनके साथ काम करने से जुड़ी ज़रूरी बातें बताई गई हैं
इंडेक्स किया जा सकने वाला टेक्स्ट और थंबनेल जैसा मेटाडेटा. फ़ाइलें शामिल करने और वापस लाने के लिए, देखें
files संसाधन.
फ़ाइल के नाम और एक्सटेंशन बताएं
फ़ाइलें डालते समय, ऐप्लिकेशन को टाइटल प्रॉपर्टी में फ़ाइल एक्सटेंशन के बारे में बताना चाहिए
के साथ करना है. उदाहरण के लिए, JPEG फ़ाइल शामिल करने की कार्रवाई में
मेटाडेटा में "name": "cat.jpg" जैसा कुछ तय करें.
बाद के GET रिस्पॉन्स में रीड-ओनली fileExtension प्रॉपर्टी शामिल हो सकती है
मूल रूप से name प्रॉपर्टी में बताए गए एक्सटेंशन से अपने-आप भर जाता है. जब
Google Drive उपयोगकर्ता, फ़ाइल को डाउनलोड करने का अनुरोध करता है या फ़ाइल डाउनलोड होती है
को लागू करता है, तो डिस्क एक पूरा फ़ाइल नाम (
एक्सटेंशन). जिन मामलों में एक्सटेंशन मौजूद नहीं है, वहां
Drive, फ़ाइल के एक्सटेंशन के आधार पर एक्सटेंशन तय करने की कोशिश करता है
MIME प्रकार.
इंडेक्स किया जा सकने वाला टेक्स्ट सेव करें
Drive, दस्तावेज़ों को खोज के लिए अपने-आप इंडेक्स करता है. ऐसा तब होता है, जब उसे
फ़ाइल टाइप की पहचान करता है. इसमें टेक्स्ट दस्तावेज़, PDF, टेक्स्ट वाली इमेज, और
अन्य सामान्य प्रकार. अगर आपका ऐप्लिकेशन दूसरी तरह की फ़ाइलें (जैसे कि ड्रॉइंग,
वीडियो, और शॉर्टकट) से जुड़ा है, तो आप
फ़ाइल के contentHints.indexableText फ़ील्ड में मौजूद टेक्स्ट को इंडेक्स किया जा सकता है.
इंडेक्स किए जा सकने वाले टेक्स्ट को एचटीएमएल के तौर पर इंडेक्स किया जाता है. अगर इंडेक्स की जा सकने वाली टेक्स्ट स्ट्रिंग सेव की जाती है, तो
<section attribute="value1">Here's some text</section>, फिर "ये रही कुछ
टेक्स्ट" इंडेक्स किया गया है, लेकिन "value1" नहीं है. इस वजह से, एक्सएमएल को इंडेक्स करने के लिए सेव किया जा रहा है
टेक्स्ट इतना उपयोगी नहीं है कि एचटीएमएल को सेव किया जा सके.
indexableText के बारे में बताते समय, इन बातों का भी ध्यान रखें:
contentHints.indexableTextका साइज़ 128 केबी से ज़्यादा नहीं होना चाहिए.- उन मुख्य शब्दों और सिद्धांतों को कैप्चर करें जिन्हें आपको उपयोगकर्ताओं को खोजना है.
- टेक्स्ट को ज़रूरी क्रम में क्रम से लगाने की कोशिश न करें, क्योंकि इंडेक्स करने वाला टूल ऐसा करता है बेहतर तरीके से काम करता है.
- आपके ऐप्लिकेशन को हर बार सेव किए जाने पर इंडेक्स किए जा सकने वाले टेक्स्ट को अपडेट करना चाहिए.
- पक्का करें कि टेक्स्ट, फ़ाइल के कॉन्टेंट या मेटाडेटा से जुड़ा हो.
आपको यह आखिरी बात साफ़-साफ़ लग सकती है, लेकिन यह ज़रूरी है. Google Merchant Center में फ़ाइल को खोज के नतीजों में दिखाने के लिए, आम तौर पर खोजे जाने वाले शब्दों को जोड़ना होगा. यह उपयोगकर्ताओं को परेशानी हो सकती है. साथ ही, उन्हें फ़ाइल मिटाने के लिए बढ़ावा भी मिल सकता है.
थंबनेल अपलोड करना
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 में मौजूद फ़ाइलों के लिए मेटाडेटा वापस लाया जा सकता है. इसमें थंबनेल भी शामिल हैं.
थंबनेल जानकारी को इसके thumbnailLink फ़ील्ड में रखा जाता है:
files संसाधन.
कोई थंबनेल दिखाना
नीचे दिया गया कोड सैंपल,
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 प्रकार सेट करें. उदाहरण के लिए, नीचे दिया गया कोड सैंपल, सूची बनाने की सुविधा देता है. 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)