अगर आपने किसी स्क्रिप्ट के लिए यूज़र इंटरफ़ेस बनाया है, तो उसे वेब ऐप्लिकेशन खोलें. उदाहरण के लिए, एक ऐसी स्क्रिप्ट जिसकी मदद से लोग अपॉइंटमेंट शेड्यूल कर सकते हैं सहायता टीम के सदस्यों को एक वेब ऐप्लिकेशन के रूप में दिखाया जाएगा, ताकि उपयोगकर्ता इसे सीधे अपने ब्राउज़र से ऐक्सेस कर सकते हैं.
स्टैंडअलोन स्क्रिप्ट और ऐप्लिकेशन को Google Workspace इस्तेमाल करने के लिए बाध्य करने वाली स्क्रिप्ट इसे बनाया जा सकता है वेब ऐप्लिकेशन सबमिट करते हैं, जब तक कि वे नीचे दी गई ज़रूरी शर्तों को पूरा करते हों.
वेब ऐप्लिकेशन के लिए ज़रूरी शर्तें
स्क्रिप्ट को वेब ऐप्लिकेशन के तौर पर पब्लिश किया जा सकता है. इसके लिए, ज़रूरी है कि वह इन शर्तों को पूरा करती हो:
- इसमें
doGet(e)याdoPost(e)फ़ंक्शन होता है. - फ़ंक्शन एक HTML सेवा दिखाता है
HtmlOutputऑब्जेक्ट या कॉन्टेंट सेवाTextOutputऑब्जेक्ट.
अनुरोध के पैरामीटर
जब कोई उपयोगकर्ता किसी ऐप्लिकेशन पर जाता है या कोई प्रोग्राम, ऐप्लिकेशन को एचटीटीपी GET अनुरोध भेजता है,
Apps Script, doGet(e) फ़ंक्शन को चलाता है. जब कोई प्रोग्राम, ऐप्लिकेशन को एचटीटीपी भेजता है
POST अनुरोध के लिए, Apps Script के बजाय doPost(e) का इस्तेमाल किया जा रहा है. दोनों मामलों में, e
आर्ग्युमेंट एक ऐसे इवेंट पैरामीटर को दिखाता है जिसमें
अनुरोध पैरामीटर. इवेंट ऑब्जेक्ट का स्ट्रक्चर टेबल में दिखाया गया है
नीचे दिया गया है:
| फ़ील्ड | |
|---|---|
e.queryString |
यूआरएल की क्वेरी स्ट्रिंग वाले हिस्से का मान या अगर कोई क्वेरी स्ट्रिंग नहीं दी गई है, तो name=alice&n=1&n=2 |
e.parameter |
अनुरोध पैरामीटर से जुड़े कुंजी/वैल्यू पेयर का ऑब्जेक्ट. एक से ज़्यादा वैल्यू वाले पैरामीटर के लिए, सिर्फ़ पहली वैल्यू दिखाई जाती है. {"name": "alice", "n": "1"}
|
e.parameters |
एक ऑब्जेक्ट जो {"name": ["alice"], "n": ["1", "2"]}
|
e.pathInfo |
|
e.contextPath |
इस्तेमाल नहीं किया गया, हमेशा खाली स्ट्रिंग. |
e.contentLength |
पीओएसटी से जुड़े अनुरोधों के लिए अनुरोध के लेख की लंबाई या जीईटी अनुरोधों के लिए 332 |
e.postData.length |
332 |
e.postData.type |
पीओएसटी का एमआईएमई टाइप text/csv |
e.postData.contents |
पीओएसटी का कॉन्टेंट टेक्स्ट Alice,21 |
e.postData.name |
हमेशा "postData" वैल्यू postData |
उदाहरण के लिए, username और age जैसे पैरामीटर पास किए जा सकते हैं
जोड़ें, जैसा कि नीचे दिखाया गया है:
https://script.google.com/.../exec?username=jsmith&age=21
इसके बाद, इस तरह से पैरामीटर दिखाए जा सकते हैं:
function doGet(e) {
var params = JSON.stringify(e);
return ContentService.createTextOutput(params).setMimeType(ContentService.MimeType.JSON);
}
ऊपर दिए गए उदाहरण में, doGet(e) यह आउटपुट दिखाता है:
{
"queryString": "username=jsmith&age=21",
"parameter": {
"username": "jsmith",
"age": "21"
},
"contextPath": "",
"parameters": {
"username": [
"jsmith"
],
"age": [
"21"
]
},
"contentLength": -1
}
स्क्रिप्ट को वेब ऐप्लिकेशन के तौर पर डिप्लॉय करें
स्क्रिप्ट को वेब ऐप्लिकेशन के तौर पर डिप्लॉय करने के लिए, यह तरीका अपनाएं:
- स्क्रिप्ट प्रोजेक्ट में सबसे ऊपर दाईं ओर, Deploy पर क्लिक करें > नया डिप्लॉयमेंट.
- "टाइप चुनें" के बगल में, 'डिप्लॉयमेंट टाइप चालू करें' पर क्लिक करें वेब ऐप्लिकेशन.
- "डिप्लॉयमेंट" में दिए गए फ़ील्ड में अपने वेब ऐप्लिकेशन के बारे में जानकारी डालें कॉन्फ़िगरेशन."
- डिप्लॉय करें पर क्लिक करें.
आप वेब ऐप्लिकेशन का URL उन लोगों के साथ शेयर कर सकते हैं, जिनके साथ आप अपने ऐप्लिकेशन का उपयोग करना चाहते हैं, यह ज़रूरी है कि आपने उन्हें ऐक्सेस दिया हो.
वेब ऐप्लिकेशन डिप्लॉयमेंट की जांच करना
अपनी स्क्रिप्ट को वेब ऐप्लिकेशन के रूप में टेस्ट करने के लिए, नीचे दिया गया तरीका अपनाएं:
- स्क्रिप्ट प्रोजेक्ट में सबसे ऊपर दाईं ओर, Deploy > पर क्लिक करें जांच करें डिप्लॉयमेंट में शामिल हैं.
- "टाइप चुनें" के बगल में, 'डिप्लॉयमेंट टाइप चालू करें' पर क्लिक करें > वेब ऐप्लिकेशन.
- वेब ऐप्लिकेशन के यूआरएल के नीचे, कॉपी करें पर क्लिक करें.
यूआरएल को अपने ब्राउज़र में चिपकाएं और अपने वेब ऐप्लिकेशन की जांच करें.
यह यूआरएल
/devसे खत्म होता है. इसे सिर्फ़ वे उपयोगकर्ता ऐक्सेस कर सकते हैं जिनके पास बदलाव करने का ऐक्सेस है को भी स्क्रिप्ट में बदलेंगे. ऐप्लिकेशन का यह इंस्टेंस, हमेशा सबसे हाल ही में सेव किया गया इवेंट चलाता है कोड और इसे सिर्फ़ डेवलपमेंट के दौरान टेस्ट किया जा सकता है.
अनुमतियां
किसी वेब ऐप्लिकेशन के लिए अनुमतियां, इस आधार पर अलग-अलग होती हैं कि आपने कैसे एक्ज़ीक्यूट किया ऐप्लिकेशन:
- ऐप्लिकेशन को मेरी तरह एक्ज़ीक्यूट करें—इस मामले में, स्क्रिप्ट हमेशा आपके पास स्क्रिप्ट का मालिकाना हक होगा, भले ही वेब ऐप्लिकेशन को कोई भी ऐक्सेस कर सकता हो.
- वेब ऐप्लिकेशन को ऐक्सेस करने वाले उपयोगकर्ता के रूप में ऐप्लिकेशन को एक्ज़ीक्यूट करें—इस मामले में, स्क्रिप्ट वेब ऐप्लिकेशन का इस्तेमाल करने वाले सक्रिय उपयोगकर्ता की पहचान के तहत चलता है. यह अनुमति अप्रोच की वजह से वेब ऐप्लिकेशन, स्क्रिप्ट के मालिक का ईमेल तब दिखाता है, जब उपयोगकर्ता ऐक्सेस देता है.
अपने वेब ऐप्लिकेशन को Google Sites में एम्बेड करना
Google Sites में वेब ऐप्लिकेशन को एम्बेड करने के लिए, सबसे पहले
डिप्लॉय किया गया. आपको यह भी
Deploy डायलॉग से डिप्लॉय किया गया यूआरएल चाहिए.
किसी वेब ऐप्लिकेशन को Sites में एम्बेड करने के लिए इस पेज पर, यह तरीका अपनाएं:
- वह साइट पेज खोलें जहां आपको वेब ऐप्लिकेशन जोड़ना है.
- शामिल करें > यूआरएल एम्बेड करें.
- वेब ऐप्लिकेशन का यूआरएल चिपकाएं और जोड़ें पर क्लिक करें.
वेब ऐप्लिकेशन, पेज की झलक में एक फ़्रेम में दिखता है. पब्लिश करने पर तो आपकी साइट के दर्शकों को वेब ऐप्लिकेशन को ऐक्सेस करने से पहले सामान्य तरीके से काम करता है. बिना मंज़ूरी वाले वेब ऐप्लिकेशन, अनुमति देने के अनुरोध इन जगहों पर दिखाते हैं उपयोगकर्ता है.
वेब ऐप्लिकेशन और ब्राउज़र इतिहास
अगर किसी Apps Script वेब ऐप्लिकेशन को एक से ज़्यादा पेज वाले वर्शन का अनुभव देना हो, तो ऐप्लिकेशन हो सकता है या ऐसा डाइनैमिक यूज़र इंटरफ़ेस (यूआई) है जिसे यूआरएल पैरामीटर से कंट्रोल किया जाता है. यह काम अच्छी तरह से करने के लिए, आप ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) या पेज पर क्लिक कर सकते हैं और राज्य को ब्राउज़र इतिहास में जब उपयोगकर्ता आपके ऐप्लिकेशन पर जाता है. आप इतिहास की घटनाओं को भी सुन सकते हैं ताकि आपका वेब ऐप्लिकेशन, सही यूज़र इंटरफ़ेस (यूआई) दिखाता है. ऐसा तब होता है, जब उपयोगकर्ता ब्राउज़र बटन. लोड होने के समय यूआरएल पैरामीटर से क्वेरी करके, आप ऐप्लिकेशन डाइनैमिक तौर पर उन पैरामीटर के आधार पर अपना यूज़र इंटरफ़ेस (यूआई) बनाता है. इससे उपयोगकर्ता ऐप्लिकेशन को किसी खास स्थिति में शुरू करें.
Apps Script, आपकी मदद करने के लिए दो एसिंक्रोनस क्लाइंट-साइड JavaScript एपीआई उपलब्ध कराती है ऐसे वेब ऐप्लिकेशन बनाकर:
google.script.historyब्राउज़र इतिहास के बदलावों के लिए डाइनैमिक रिस्पॉन्स की अनुमति देने वाले तरीके उपलब्ध कराता है. यह इसमें ये शामिल हैं: ब्राउज़र पर स्थितियां (आसान ऑब्जेक्ट जिन्हें तय किया जा सकता है) पुश करना इतिहास, इतिहास स्टैक में टॉप स्टेट को बदलना, और लिसनर सेट करना कॉलबैक फ़ंक्शन का इस्तेमाल करें.google.script.urlउपलब्ध कराता है मौजूदा पेज के यूआरएल पैरामीटर और यूआरएल फ़्रैगमेंट को फिर से पाने का तरीका, अगर वे मौजूद हैं.
ये इतिहास एपीआई सिर्फ़ वेब ऐप्लिकेशन के लिए उपलब्ध हैं. वे नहीं हैं ये साइडबार, डायलॉग या ऐड-ऑन के साथ काम करते हैं. यह सुविधा, में उपयोग करने के लिए सुझाए गए नहीं किसी Google साइट में एम्बेड किए गए वेब ऐप्लिकेशन हों.