फ़ाइल मेटाडेटा मैनेज करना

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

इस दस्तावेज़ में फ़ाइलों के नाम तय करने और थंबनेल और इंडेक्स किए जा सकने वाले टेक्स्ट जैसे मेटाडेटा के साथ काम करने से जुड़ी अहम जानकारी शामिल है. फ़ाइलें शामिल करना और उन्हें वापस पाना शुरू करने के लिए, फ़ाइलों के बारे में जानकारी देखें.

फ़ाइल के नाम और एक्सटेंशन के बारे में बताएं

एपीआई की मदद से फ़ाइलें जोड़ते समय, ऐप्लिकेशन को शीर्षक प्रॉपर्टी में फ़ाइल एक्सटेंशन के बारे में बताना चाहिए. उदाहरण के लिए, JPEG फ़ाइल शामिल करने की कार्रवाई के लिए मेटाडेटा में "name": "cat.jpg" जैसा कुछ होना चाहिए.

इसके बाद के GET रिस्पॉन्स में, रीड-ओनली fileExtension प्रॉपर्टी शामिल की जा सकती है, जिसमें name प्रॉपर्टी में मूल रूप से तय किया गया एक्सटेंशन शामिल होता है. जब कोई Google Drive उपयोगकर्ता किसी फ़ाइल को डाउनलोड करने का अनुरोध करता है या जब वह फ़ाइल सिंक क्लाइंट के ज़रिए डाउनलोड की जाती है, तब Drive एक ऐसा शीर्षक बनाता है जो फ़ाइल के शीर्षक के हिसाब से पूरा हो जाता है. ऐसे मामलों में जहां एक्सटेंशन मौजूद नहीं है, Drive, फ़ाइल के MIME टाइप के आधार पर एक्सटेंशन तय करने की कोशिश करता है.

इंडेक्स करने वाला टेक्स्ट सेव करना

जब Drive में फ़ाइल टाइप को पहचाना जाता है, तो Drive अपने-आप उसे खोज के लिए इंडेक्स कर देता है. इसमें, टेक्स्ट दस्तावेज़, PDF, टेक्स्ट वाली इमेज, और दूसरी तरह की फ़ाइलें शामिल होती हैं. अगर आपका ऐप्लिकेशन दूसरी तरह की फ़ाइलें (जैसे कि ड्रॉइंग, वीडियो, और शॉर्टकट) सेव करता है, तो फ़ाइल के contentHints.indexableText फ़ील्ड में इंडेक्स होने वाला टेक्स्ट देकर उसे और बेहतर बनाया जा सकता है.

इंडेक्स किया जा सकने वाला टेक्स्ट, एचटीएमएल के रूप में इंडेक्स किया जाता है. अगर इंडेक्स किए जा सकने वाले टेक्स्ट स्ट्रिंग को सेव किया जाता है, तो <section attribute="value1">Here's some text</section>यहां कुछ टेक्स्ट दिया गया है, लेकिन "value1" इंडेक्स नहीं है. इस वजह से, एक्सएमएल को इंडेक्स किए जा सकने वाले टेक्स्ट के तौर पर सेव करना, एचटीएमएल को सेव करने जैसा आसान नहीं है.

indexableText के बारे में जानकारी देते समय, यह भी ध्यान रखें:

  • contentHints.indexableText की साइज़ सीमा 128 केबी है.
  • उन मुख्य शब्दों और सिद्धांतों को कैप्चर करें जिनके बारे में आपको लगता है कि कोई उपयोगकर्ता उन्हें खोजेगा.
  • टेक्स्ट को अहमियत के हिसाब से क्रम में न रखें, क्योंकि इंडेक्स करने वाला आपके लिए ठीक से काम करता है.
  • आपके ऐप्लिकेशन को, सेव किया गया हर डेटा के साथ इंडेक्स करने वाला टेक्स्ट अपडेट करना चाहिए.
  • पक्का करें कि टेक्स्ट, फ़ाइल के कॉन्टेंट या मेटाडेटा से जुड़ा हो.

यह आखिरी बात साफ़ लग सकती है, लेकिन यह ज़रूरी है. आम तौर पर खोजे जाने वाले शब्दों को जोड़ना, किसी फ़ाइल को खोज नतीजों में दिखाने के लिए उसे जोड़ना अच्छा नहीं है. इससे उपयोगकर्ता परेशान हो सकते हैं और वे फ़ाइल मिटाने के लिए प्रेरित भी हो सकते हैं.

थंबनेल अपलोड करना

Drive अपने-आप कई तरह की फ़ाइलों के लिए थंबनेल जनरेट करता है. जिन शॉर्टकट और दूसरी तरह की फ़ाइलों को Drive रेंडर नहीं कर सकता, उनके लिए आप अपने ऐप्लिकेशन से जनरेट की गई थंबनेल इमेज दे सकते हैं. थंबनेल फ़ाइल अपलोड करने के लिए, create या update कॉल के दौरान फ़ाइल संसाधन पर contentHints.thumbnail प्रॉपर्टी सेट करें. इसका तरीका यहां बताया गया है:

  • contentHints.thumbnail.image को यूआरएल-सुरक्षित Base64-एन्कोडेड इमेज पर सेट करें (आरएफ़सी 4648 सेक्शन देखें).
  • contentHints.thumbnail.mimeType को इमेज फ़ॉर्मैट के लिए सही टाइप पर सेट करें.

अगर Drive, फ़ाइल से थंबनेल जनरेट कर सकती है, तो वह जनरेट किए गए थंबनेल का इस्तेमाल करेगी और आपके अपलोड किए गए किसी भी थंबनेल को अनदेखा कर देगी. अगर थंबनेल जनरेट नहीं होता है, तो आपके दिए गए थंबनेल का इस्तेमाल किया जा सकता है. ध्यान रखने वाली बातें:

  • थंबनेल PNG, GIF या JPG फ़ॉर्मैट में अपलोड किए जा सकते हैं.
  • हमारा सुझाव है कि आप 1600 पिक्सल की चौड़ाई चुनें.
  • थंबनेल का फ़ाइल आकार ज़्यादा से ज़्यादा 2 एमबी हो सकता है.
  • थंबनेल के लिए कम से कम चौड़ाई 220 पिक्सल है.
  • आपके ऐप्लिकेशन में हर सेव के साथ थंबनेल अपडेट होने चाहिए.

ज़्यादा जानकारी के लिए, फ़ाइल की जानकारी देखें.