"Drive में सेव करें" बटन की मदद से, उपयोगकर्ता आपकी वेबसाइट से Drive में फ़ाइलें सेव कर सकते हैं. उदाहरण के लिए, मान लें कि आपकी वेबसाइट पर, डिवाइस के इस्तेमाल से जुड़ी कई गाइड (PDF) मौजूद हैं, जिन्हें उपयोगकर्ता डाउनलोड कर सकते हैं. "Drive में सेव करें" बटन को हर मैन्युअल के बगल में रखा जा सकता है. इससे उपयोगकर्ता, मैन्युअल को 'मेरी ड्राइव' में सेव कर सकते हैं.
जब उपयोगकर्ता बटन पर क्लिक करता है, तो डेटा सोर्स से फ़ाइल डाउनलोड हो जाती है. साथ ही, डेटा मिलने पर उसे Google Drive पर अपलोड कर दिया जाता है. डाउनलोड की प्रोसेस, उपयोगकर्ता के ब्राउज़र के कॉन्टेक्स्ट में की जाती है. इसलिए, इस प्रोसेस से उपयोगकर्ता को अपने ब्राउज़र सेशन का इस्तेमाल करके, फ़ाइलों को सेव करने की कार्रवाई की पुष्टि करने की अनुमति मिलती है.
इन ब्राउज़र पर पासकी का इस्तेमाल किया जा सकता है
"Drive में सेव करें" बटन, इन ब्राउज़र पर काम करता है.
किसी पेज पर "Drive में सेव करें" बटन जोड़ना
"Drive में सेव करें" बटन का इंस्टेंस बनाने के लिए, अपने वेब पेज पर यह स्क्रिप्ट जोड़ें:
<script src="https://apis.google.com/js/platform.js" async defer></script>
<div class="g-savetodrive"
data-src="//example.com/path/to/myfile.pdf"
data-filename="My Statement.pdf"
data-sitename="My Company Name">
</div>
कहां:
classएक ज़रूरी पैरामीटर है. अगर स्टैंडर्ड एचटीएमएल टैग का इस्तेमाल किया जा रहा है, तो इसेg-savetodriveपर सेट करना ज़रूरी है.data-srcएक ज़रूरी पैरामीटर है. इसमें सेव की जाने वाली फ़ाइल का यूआरएल होता है.- यूआरएल, ऐब्सलूट या रिलेटिव हो सकते हैं.
data-srcयूआरएल को उसी डोमेन, सबडोमेन, और प्रोटोकॉल से दिखाया जा सकता है जहां बटन होस्ट किया गया है. आपको पेज और डेटा सोर्स के बीच मैच होने वाले प्रोटोकॉल का इस्तेमाल करना चाहिए.- डेटा यूआरआई और
file://यूआरएल का इस्तेमाल नहीं किया जा सकता. - ब्राउज़र की सेम ऑरिजिन पॉलिसी की वजह से, यह यूआरएल उसी डोमेन से दिखाया जाना चाहिए जिस पर इसे रखा गया है. इसके अलावा, इसे क्रॉस ऑरिजिन रिसॉर्स शेयरिंग (सीओआरएस) का इस्तेमाल करके भी ऐक्सेस किया जा सकता है. अगर बटन और संसाधन अलग-अलग डोमेन पर हैं, तो अलग-अलग डोमेन पर बटन और संसाधनों को मैनेज करना देखें.(#domain).
- अगर एक ही पेज को एचटीटीपी और एचटीटीपीएस, दोनों से दिखाया जाता है, तो फ़ाइल दिखाने के लिए, प्रोटोकॉल के बिना संसाधन की जानकारी दें. जैसे,
data-src="//example.com/files/file.pdf". यह होस्टिंग पेज को ऐक्सेस करने के तरीके के आधार पर, सही प्रोटोकॉल का इस्तेमाल करता है.
data-filenameएक ज़रूरी पैरामीटर है. इसमें सेव की गई फ़ाइल के लिए इस्तेमाल किया गया नाम शामिल होता है.data-sitenameएक ज़रूरी पैरामीटर है. इसमें फ़ाइल उपलब्ध कराने वाली वेबसाइट का नाम शामिल होता है.
इन एट्रिब्यूट को किसी भी एचटीएमएल एलिमेंट पर लागू किया जा सकता है. हालांकि, आम तौर पर div, span या button एलिमेंट का इस्तेमाल किया जाता है. पेज लोड होने के दौरान, इनमें से हर एलिमेंट थोड़ा अलग दिखता है. ऐसा इसलिए होता है, क्योंकि ब्राउज़र, एलिमेंट को रेंडर करता है. इसके बाद, "Drive में सेव करें" JavaScript, एलिमेंट को फिर से रेंडर करता है.
इस स्क्रिप्ट को एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करके लोड किया जाना चाहिए. साथ ही, इसे पेज पर कहीं भी बिना किसी पाबंदी के शामिल किया जा सकता है. बेहतर परफ़ॉर्मेंस के लिए, स्क्रिप्ट को एसिंक्रोनस तरीके से भी लोड किया जा सकता है.
एक पेज पर कई बटन इस्तेमाल करना
एक ही पेज पर, "Drive में सेव करें" बटन कई बार जोड़े जा सकते हैं. उदाहरण के लिए, आपके पास किसी लंबे पेज के सबसे ऊपर और सबसे नीचे एक बटन हो सकता है.
अगर कई बटन के लिए data-src और data-filename पैरामीटर एक जैसे हैं, तो किसी एक बटन से सेव करने पर, मिलते-जुलते सभी बटन पर प्रोग्रेस की एक जैसी जानकारी दिखती है. अगर अलग-अलग बटन पर क्लिक किया जाता है, तो वे क्रम से सेव होते हैं.
अलग-अलग डोमेन पर बटन और संसाधनों को मैनेज करना
अगर आपका "Drive में सेव करें" बटन, डेटा सोर्स से अलग पेज पर है, तो फ़ाइल को सेव करने के अनुरोध में, संसाधन को ऐक्सेस करने के लिए क्रॉस ऑरिजिन रिसॉर्स शेयरिंग (सीओआरएस) का इस्तेमाल करना ज़रूरी है. CORS एक ऐसा तरीका है जिससे किसी डोमेन पर मौजूद वेब ऐप्लिकेशन, दूसरे डोमेन पर मौजूद सर्वर से संसाधन ऐक्सेस कर सकता है.
उदाहरण के लिए, अगर "Drive में सेव करें" बटन को http://example.com/page.html पर किसी पेज पर रखा गया है और डेटा सोर्स को data-src="https://otherserver.com/files/file.pdf" के तौर पर तय किया गया है, तो बटन PDF को ऐक्सेस नहीं कर पाएगा. हालांकि, अगर ब्राउज़र संसाधन को ऐक्सेस करने के लिए सीओआरएस का इस्तेमाल कर सकता है, तो बटन PDF को ऐक्सेस कर पाएगा.
data-src यूआरएल को किसी दूसरे डोमेन से दिखाया जा सकता है. हालांकि, एचटीटीपी सर्वर से मिलने वाले रिस्पॉन्स में, एचटीटीपी OPTION अनुरोधों के लिए सहायता शामिल होनी चाहिए. साथ ही, इनमें ये खास एचटीटीपी हेडर शामिल होने चाहिए:
Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: Range
Access-Control-Expose-Headers: Cache-Control, Content-Encoding, Content-Range
Access-Control-Allow-Origin की वैल्यू * हो सकती है, ताकि किसी भी डोमेन से सीओआरएस को अनुमति दी जा सके. इसके अलावा, उन डोमेन के बारे में भी बताया जा सकता है जिनके पास सीओआरएस के ज़रिए संसाधन का ऐक्सेस है, जैसे कि http://example.com/page.html. अगर आपके पास कॉन्टेंट को होस्ट करने के लिए कोई सर्वर नहीं है, तो Google App Engine का इस्तेमाल करें.
ज़्यादा जानकारी के लिए, अपने सर्वर के दस्तावेज़ देखें. इनमें "Drive में सेव करें" बटन दिखाने वाले ऑरिजिन से, सीओआरएस को चालू करने का तरीका बताया गया है. अपने सर्वर के लिए सीओआरएस को चालू करने के बारे में ज़्यादा जानकारी पाने के लिए, मुझे अपने सर्वर में सीओआरएस की सुविधा जोड़नी है लेख पढ़ें.
JavaScript API
"Drive में सेव करें" बटन का JavaScript, gapi.savetodrive नेमस्पेस के तहत दो बटन-रेंडरिंग फ़ंक्शन तय करता है. अगर आपने अपने-आप रेंडर होने की सुविधा बंद की है, तो आपको parsetags को explicit पर सेट करके, इनमें से किसी एक फ़ंक्शन को कॉल करना होगा.
| तरीका | ब्यौरा |
|---|---|
gapi.savetodrive.render( |
यह दिए गए कंटेनर को "Drive में सेव करें" बटन विजेट के तौर पर रेंडर करता है.
|
gapi.savetodrive.go( |
यह तय किए गए कंटेनर में, "Drive में सेव करें" के सभी टैग और क्लास को रेंडर करता है.
इस फ़ंक्शन का इस्तेमाल सिर्फ़ तब किया जाना चाहिए, जब parsetags को explicit पर सेट किया गया हो. ऐसा परफ़ॉर्मेंस को बेहतर बनाने के लिए किया जा सकता है.
|
"Drive में सेव करें" JavaScript का उदाहरण, जिसमें साफ़ तौर पर लोड करने की सुविधा है
<!DOCTYPE html>
<html>
<head>
<title>Save to Drive Demo: Explicit Load</title>
<link rel="canonical" href="http://www.example.com">
<script src="https://apis.google.com/js/platform.js" async defer>
{parsetags: 'explicit'}
</script>
</head>
<body>
<div id="container">
<div class="g-savetodrive"
data-src="//example.com/path/to/myfile.pdf"
data-filename="My Statement.pdf"
data-sitename="My Company Name">
<div>
</div>
<script type="text/javascript">
gapi.savetodrive.go('container');
</script>
</body>
</html>
एक्सप्लिसिट रेंडर के साथ "Drive में सेव करें" JavaScript का उदाहरण
<!DOCTYPE html>
<html>
<head>
<title>Save to Drive Demo: Explicit Render</title>
<link rel="canonical" href="http://www.example.com">
<script>
window.___gcfg = {
parsetags: 'explicit'
};
</script>
<script src="https://apis.google.com/js/platform.js" async defer></script>
</head>
<body>
<a href="javascript:void(0)" id="render-link">Render the Save to Drive button</a>
<div id="savetodrive-div"></div>
<script>
function renderSaveToDrive() {
gapi.savetodrive.render('savetodrive-div', {
src: '//example.com/path/to/myfile.pdf',
filename: 'My Statement.pdf',
sitename: 'My Company Name'
});
}
document.getElementById('render-link').addEventListener('click', renderSaveToDrive);
</script>
</body>
</html>
"Drive में सेव करें" बटन को स्थानीय भाषा में उपलब्ध कराना
अगर आपका वेब पेज किसी खास भाषा के साथ काम करता है, तो window.___gcfg.lang वैरिएबल को उस भाषा पर सेट करें. अगर यह सेट नहीं है, तो उपयोगकर्ता के Google Drive की भाषा का इस्तेमाल किया जाता है.
भाषा कोड की उपलब्ध वैल्यू के लिए, इस्तेमाल किए जा सकने वाले भाषा कोड की सूची देखें.
<!DOCTYPE html>
<html>
<head>
<title>Save to Drive Demo: Async Load with Language</title>
<link rel="canonical" href="http://www.example.com">
</head>
<body>
<div class="g-savetodrive"
data-src="//example.com/path/to/myfile.pdf"
data-filename="My Statement.pdf"
data-sitename="My Company Name">
</div>
<script type="text/javascript">
window.___gcfg = {
lang: 'en-US'
};
</script>
<script src = 'https://apis.google.com/js/platform.js' async defer></script>
</body>
</html>
समस्या का हल
अगर आपको data-src यूआरएल डाउनलोड करते समय एक्सएचआर से जुड़ी गड़बड़ी मिलती है, तो पुष्टि करें कि संसाधन असल में मौजूद है. साथ ही, यह भी पक्का करें कि आपको CORS से जुड़ी कोई समस्या न हो.
अगर बड़ी फ़ाइलों को काटकर 2 एमबी कर दिया जाता है, तो हो सकता है कि आपका सर्वर, Content-Range को एक्सपोज़ न कर रहा हो. ऐसा CORS की समस्या की वजह से हो सकता है.