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

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

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

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

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

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

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-कोड में बदली गई इमेज पर सेट करें (RFC 4648 सेक्शन 5 देखें).
  • थंबनेल के लिए, contentHints.thumbnail.mimeType फ़ील्ड को सही MIME टाइप पर सेट करें.

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

थंबनेल को इन नियमों का पालन करना चाहिए:

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

ज़्यादा जानकारी के लिए, files संसाधन देखें.

थंबनेल वापस पाना

Drive में मौजूद फ़ाइलों का मेटाडेटा भी वापस पाया जा सकता है. इसमें थंबनेल भी शामिल हैं. थंबनेल की जानकारी, files संसाधन के thumbnailLink फ़ील्ड में होती है.

कोई खास थंबनेल दिखाएं

किसी खास फ़ाइल का thumbnailLink मेटाडेटा देने के लिए, नीचे दिया गया कोड सैंपल, क्वेरी पैरामीटर के तौर पर कई फ़ील्ड के साथ files.get तरीके का अनुरोध दिखाता है. ज़्यादा जानकारी के लिए, किसी फ़ाइल के लिए खास फ़ील्ड लौटाना देखें.

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink

FILE_ID को उस फ़ाइल के fileId से बदलें जिसे आपको ढूंढना है.

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

थंबनेल की सूची दिखाएं

नीचे दिया गया कोड सैंपल, फ़ाइलों की सूची के लिए thumbnailLink मेटाडेटा देने के लिए, क्वेरी पैरामीटर के तौर पर कई फ़ील्ड के साथ files.list तरीके का अनुरोध दिखाता है. ज़्यादा जानकारी के लिए, फ़ाइलें और फ़ोल्डर खोजें देखें.

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)