Google Drive API, डाउनलोड और एक्सपोर्ट करने से जुड़ी कई तरह की कार्रवाइयों के साथ काम करता है. इन कार्रवाइयों के बारे में नीचे दी गई टेबल में बताया गया है:
कार्रवाइयां डाउनलोड करना |
|
||||
एक्सपोर्ट से जुड़ी कार्रवाइयां |
|
फ़ाइल का कॉन्टेंट डाउनलोड या एक्सपोर्ट करने से पहले, पुष्टि करें कि उपयोगकर्ता files
संसाधन पर मौजूद capabilities.canDownload
फ़ील्ड का इस्तेमाल करके, फ़ाइल डाउनलोड कर सकते हैं.
यहां बताए गए फ़ाइल टाइप की जानकारी के लिए, फ़ाइल टाइप देखें. इन फ़ाइल टाइप में, BLOB और Google Workspace फ़ाइलें भी शामिल हैं.
इस गाइड के बाकी हिस्से में, डाउनलोड और एक्सपोर्ट करने से जुड़ी इन कार्रवाइयों को करने के बारे में पूरी जानकारी दी गई है.
ब्लॉब फ़ाइल का कॉन्टेंट डाउनलोड करना
Drive में सेव की गई ब्लॉब फ़ाइल डाउनलोड करने के लिए, files.get
तरीके का इस्तेमाल करें. इसके लिए, डाउनलोड की जाने वाली फ़ाइल का आईडी और alt=media
यूआरएल पैरामीटर डालें. 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
ब्लॉब फ़ाइल का कॉन्टेंट, किसी पुराने वर्शन में डाउनलोड करना
ब्लॉब फ़ाइलों के कॉन्टेंट को पुराने वर्शन में डाउनलोड करने के लिए, revisions.get
तरीके का इस्तेमाल करें. इसके लिए, डाउनलोड की जाने वाली फ़ाइल का आईडी, बदलाव का आईडी, और alt=media
यूआरएल पैरामीटर डालें.
alt=media
यूआरएल पैरामीटर से सर्वर को पता चलता है कि जवाब के वैकल्पिक फ़ॉर्मैट के तौर पर, कॉन्टेंट को डाउनलोड करने का अनुरोध किया जा रहा है. files.get
की तरह, revisions.get
वाले तरीके में भी वैकल्पिक क्वेरी पैरामीटर acknowledgeAbuse
और Range
हेडर को स्वीकार किया जाता है. बदलाव डाउनलोड करने के बारे में ज़्यादा जानकारी के लिए, फ़ाइल में किए गए बदलाव मैनेज करना देखें.
अनुरोध का प्रोटोकॉल यहां दिखाया गया है.
GET https://www.googleapis.com/drive/v3/files/{FILE_ID
}/revisions/{REVISION_ID
}?alt=media
ब्राउज़र में ब्लॉब फ़ाइल का कॉन्टेंट डाउनलोड करना
Drive पर सेव की गई ब्लॉब फ़ाइलों के कॉन्टेंट को ब्राउज़र में डाउनलोड करने के लिए, एपीआई के बजाय, files
संसाधन के webContentLink
फ़ील्ड का इस्तेमाल करें. अगर उपयोगकर्ता के पास फ़ाइल को डाउनलोड करने का ऐक्सेस है, तो उसे फ़ाइल और उसके कॉन्टेंट को डाउनलोड करने का लिंक दिया जाता है. उपयोगकर्ता को इस यूआरएल पर रीडायरेक्ट किया जा सकता है या उसे क्लिक किए जा सकने वाले लिंक के तौर पर उपलब्ध कराया जा सकता है.
लंबे समय तक चलने वाले ऑपरेशन के दौरान, ब्लॉब फ़ाइल का कॉन्टेंट डाउनलोड करना
लंबे समय तक चलने वाले ऑपरेशन के दौरान, ब्लॉब फ़ाइलों का कॉन्टेंट डाउनलोड करने के लिए, files.download
तरीके का इस्तेमाल करें. इसके लिए, डाउनलोड की जाने वाली फ़ाइल के आईडी का इस्तेमाल करें. आपके पास बदलाव का आईडी सेट करने का विकल्प भी है. सिर्फ़ इस तरीके से Google Vids की फ़ाइलें डाउनलोड की जा सकती हैं. ज़्यादा जानकारी के लिए, लंबे समय तक चलने वाली कार्रवाइयों को मैनेज करना देखें.
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
तरीके का इस्तेमाल करें. इसके लिए, डाउनलोड करने के लिए फ़ाइल का आईडी और बदलाव का आईडी डालें. इससे, एक्सपोर्ट करने का लिंक जनरेट होगा. इस लिंक से, दस्तावेज़ को डाउनलोड किया जा सकता है. अगर उपयोगकर्ता के पास फ़ाइल को डाउनलोड करने का ऐक्सेस है, तो फ़ाइल और उसका कॉन्टेंट डाउनलोड करने का लिंक दिखता है. उपयोगकर्ता को इस यूआरएल पर रीडायरेक्ट किया जा सकता है या उसे क्लिक किए जा सकने वाले लिंक के तौर पर दिखाया जा सकता है.
लंबे समय तक चलने वाले ऑपरेशन के दौरान, Google Workspace दस्तावेज़ का कॉन्टेंट एक्सपोर्ट करना
लंबे समय तक चलने वाले ऑपरेशन के दौरान, Google Workspace दस्तावेज़ का कॉन्टेंट एक्सपोर्ट करने के लिए, files.download
तरीके का इस्तेमाल करें. इसके लिए, डाउनलोड की जाने वाली फ़ाइल का आईडी और बदलाव का आईडी डालें. ज़्यादा जानकारी के लिए,
लंबे समय तक चलने वाली कार्रवाइयां मैनेज करना देखें.