Google Drive API, कई तरह की डाउनलोड और एक्सपोर्ट से जुड़ी कार्रवाइयों का इस्तेमाल करता है, जैसा कि इस टेबल में बताया गया है:
वीडियो डाउनलोड करने की सुविधा |
|
|||
एक्सपोर्ट |
|
फ़ाइल का कॉन्टेंट डाउनलोड या एक्सपोर्ट करने से पहले, पुष्टि करें कि उपयोगकर्ता files
संसाधन पर मौजूद capabilities.canDownload
फ़ील्ड का इस्तेमाल करके फ़ाइल डाउनलोड कर सकते हैं.
इस गाइड के बाकी हिस्से में, इस तरह की डाउनलोड और एक्सपोर्ट कार्रवाइयों के लिए पूरी जानकारी दी गई है.
blob फ़ाइल का कॉन्टेंट डाउनलोड करें
Drive में सेव की गई blob फ़ाइल डाउनलोड करने के लिए, डाउनलोड करने के लिए फ़ाइल के आईडी और alt=media
यूआरएल पैरामीटर के साथ, files.get
तरीके का इस्तेमाल करें. alt=media
यूआरएल पैरामीटर, सर्वर को बताता है कि कॉन्टेंट को डाउनलोड करने का अनुरोध, रिस्पॉन्स के वैकल्पिक फ़ॉर्मैट के तौर पर किया जा रहा है.
alt=media
यूआरएल पैरामीटर एक सिस्टम पैरामीटर है. यह सभी Google REST API में उपलब्ध होता है. अगर Drive API के लिए क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है, तो आपको इस पैरामीटर को साफ़ तौर पर सेट करने की ज़रूरत नहीं है.
नीचे दिया गया कोड सैंपल, Drive API क्लाइंट लाइब्रेरी से फ़ाइल डाउनलोड करने के लिए, files.get
तरीके का इस्तेमाल करने का तरीका दिखाता है.
Java
Python
Node.js
PHP
.NET
यह कोड सैंपल, लाइब्रेरी वाले तरीके का इस्तेमाल करता है, जो एचटीटीपी अनुरोध में alt=media
यूआरएल पैरामीटर जोड़ता है.
आपके ऐप्लिकेशन से शुरू की गई फ़ाइल को ऐसे दायरे में होना चाहिए जिससे फ़ाइल के कॉन्टेंट को पढ़ने की अनुमति मिल सके. उदाहरण के लिए, drive.readonly.metadata
दायरे का इस्तेमाल करने वाले ऐप्लिकेशन को फ़ाइल का कॉन्टेंट डाउनलोड करने की अनुमति नहीं होती.
कोड का यह नमूना, “drive” फ़ाइल के उस स्कोप का इस्तेमाल करता है जिससे उपयोगकर्ता, Drive में मौजूद आपकी सभी फ़ाइलों को देख सकते हैं और उन्हें मैनेज कर सकते हैं. Drive के स्कोप के बारे में ज़्यादा जानने के लिए, Google Drive API के दायरे चुनना लेख पढ़ें.
जिन उपयोगकर्ताओं के पास बदलाव करने की अनुमतियां हैं वे copyRequiresWriterPermission
फ़ील्ड को false
पर सेट करके, रीड-ओनली उपयोगकर्ताओं को डाउनलोड करने से रोक सकते हैं.
आपत्तिजनक
(जैसे कि नुकसान पहुंचाने वाला सॉफ़्टवेयर) के तौर पर पहचानी गई फ़ाइलों को सिर्फ़ फ़ाइल का मालिक ही डाउनलोड कर सकता है.
इसके अलावा, get
क्वेरी पैरामीटर acknowledgeAbuse=true
को यह बताने के लिए शामिल
किया जाना चाहिए कि उपयोगकर्ता ने संभावित रूप से अनचाहे सॉफ़्टवेयर या बुरे बर्ताव वाली दूसरी फ़ाइलों को डाउनलोड
करने के जोखिम को स्वीकार किया है. आपके ऐप्लिकेशन को इस क्वेरी पैरामीटर का इस्तेमाल करने से पहले
उपयोगकर्ता को इंटरैक्टिव तरीके से चेतावनी देनी चाहिए.
आंशिक डाउनलोड
कुछ हद तक डाउनलोड होने में, फ़ाइल का सिर्फ़ एक तय हिस्सा डाउनलोड होता है. आपके पास फ़ाइल का वह हिस्सा तय करने का विकल्प होता है जिसे आपको डाउनलोड करना है. इसके लिए, Range
हेडर के साथ बाइट रेंज
का इस्तेमाल करें. उदाहरण के लिए:
Range: bytes=500-999
blob फ़ाइल का कॉन्टेंट पहले के वर्शन में डाउनलोड करना
ब्लॉब फ़ाइलों का कॉन्टेंट डाउनलोड करने के लिए, डाउनलोड किए जाने वाले फ़ाइल आईडी, बदलाव के आईडी, और alt=media
यूआरएल पैरामीटर के साथ revisions.get
तरीके का इस्तेमाल करें.
alt=media
यूआरएल पैरामीटर, सर्वर को बताता है कि कॉन्टेंट को डाउनलोड करने का अनुरोध, रिस्पॉन्स के वैकल्पिक फ़ॉर्मैट के तौर पर किया जा रहा है. files.get
की तरह ही, revisions.get
वाला तरीका भी वैकल्पिक क्वेरी पैरामीटर
acknowledgeAbuse
और Range
हेडर के साथ काम करता है. बदलावों को डाउनलोड करने के बारे में ज़्यादा जानने के लिए, फ़ाइल में हुए बदलाव डाउनलोड और पब्लिश करना देखें.
ब्राउज़र में blob फ़ाइल का कॉन्टेंट डाउनलोड करना
Drive पर सेव की गई blob फ़ाइलों का कॉन्टेंट किसी ब्राउज़र में डाउनलोड करने के लिए, एपीआई के बजाय, files
संसाधन के webContentLink
फ़ील्ड का इस्तेमाल करें. अगर उपयोगकर्ता के पास फ़ाइल को डाउनलोड करने का ऐक्सेस है, तो फ़ाइल और उसका कॉन्टेंट डाउनलोड करने का लिंक दिखता है. उपयोगकर्ता को इस यूआरएल पर रीडायरेक्ट किया जा सकता है या उसे क्लिक किए जा सकने वाले लिंक के तौर पर दिखाया जा सकता है.
Google Workspace दस्तावेज़ का कॉन्टेंट एक्सपोर्ट करें
Google Workspace के दस्तावेज़ बाइट कॉन्टेंट को एक्सपोर्ट करने के लिए, फ़ाइल के आईडी के साथ files.export
तरीके और सही MIME टाइप का इस्तेमाल करें. एक्सपोर्ट किया गया कॉन्टेंट
10 एमबी तक हो सकता है.
नीचे दिया गया कोड सैंपल, Drive API क्लाइंट लाइब्रेरी का इस्तेमाल करके, Google Workspace दस्तावेज़ को PDF फ़ॉर्मैट में एक्सपोर्ट करने के लिए, files.export
तरीके का इस्तेमाल करने का तरीका बताता है:
Java
Python
Node.js
PHP
.NET
कोड का यह नमूना, drive
के उस प्रतिबंधित दायरे का इस्तेमाल करता है जिसकी मदद से उपयोगकर्ता, Drive में मौजूद आपकी सभी फ़ाइलें देख सकते हैं और उन्हें मैनेज कर सकते हैं. Drive के स्कोप के बारे में ज़्यादा जानने के लिए, Google Drive API के दायरे चुनना लेख पढ़ें.
कोड सैंपल, एक्सपोर्ट MIME टाइप को भी application/pdf
के तौर पर बताता है. Google Workspace के हर दस्तावेज़ में काम करने वाले, एक्सपोर्ट MIME टाइप की पूरी सूची देखने के लिए, Google Workspace के दस्तावेज़ों के लिए MIME टाइप एक्सपोर्ट करें देखें.
Google Workspace दस्तावेज़ के कॉन्टेंट को ब्राउज़र में एक्सपोर्ट करना
किसी ब्राउज़र में Google Workspace के दस्तावेज़ का कॉन्टेंट एक्सपोर्ट करने के लिए, files
संसाधन के exportLinks
फ़ील्ड का इस्तेमाल करें. दस्तावेज़ किस तरह का है, इस पर निर्भर करते हुए, फ़ाइल और उसकी सामग्री को डाउनलोड करने का लिंक हर उपलब्ध MIME टाइप के लिए दिखाया जाता है. उपयोगकर्ता को यूआरएल पर रीडायरेक्ट किया जा सकता है या उसे क्लिक किए जा सकने वाले लिंक के तौर पर दिखाया जा सकता है.
Google Workspace दस्तावेज़ के कॉन्टेंट को ब्राउज़र में, किसी पुराने वर्शन पर एक्सपोर्ट करना
Google Workspace दस्तावेज़ के कॉन्टेंट को किसी ब्राउज़र में पहले के वर्शन में एक्सपोर्ट करने के लिए, डाउनलोड की जाने वाली फ़ाइल का आईडी और बदलाव के आईडी के साथ, revisions.get
तरीके का इस्तेमाल करें. अगर उपयोगकर्ता के पास फ़ाइल को डाउनलोड करने का ऐक्सेस है, तो फ़ाइल और उसका कॉन्टेंट डाउनलोड करने का लिंक दिखता है. उपयोगकर्ता को इस यूआरएल पर रीडायरेक्ट किया जा सकता है या उसे क्लिक किए जा सकने वाले लिंक के तौर पर दिखाया जा सकता है.