कंटेनर से जुड़ी स्क्रिप्ट

अगर कोई स्क्रिप्ट, Google Sheets, Docs, Slides या Forms की किसी फ़ाइल से जुड़ी है, तो इसका मतलब है कि उसे किसी दस्तावेज़ से बनाया गया है. ऐसा तब होता है, जब उसे स्टैंडअलोन स्क्रिप्ट के तौर पर न बनाया गया हो. जिस फ़ाइल से स्क्रिप्ट जुड़ी होती है उसे "कंटेनर" कहा जाता है. आम तौर पर, बाउंड स्क्रिप्ट, स्टैंडअलोन स्क्रिप्ट की तरह ही काम करती हैं. हालांकि, इनमें कुछ अंतर होते हैं. जैसे, ये Google Drive में नहीं दिखतीं, इन्हें उस फ़ाइल से अलग नहीं किया जा सकता जिससे ये जुड़ी होती हैं, और इन्हें पैरंट फ़ाइल के मुकाबले कुछ खास सुविधाएं मिलती हैं.

ध्यान दें कि स्क्रिप्ट को Google Sites से भी जोड़ा जा सकता है. हालांकि, इन स्क्रिप्ट को लगभग हमेशा वेब ऐप्लिकेशन के तौर पर डिप्लॉय किया जाता है. Google Sheets, Docs, Slides या Forms से जुड़ी स्क्रिप्ट को भी वेब ऐप्लिकेशन बनाया जा सकता है. हालांकि, ऐसा कम ही होता है.

ध्यान दें: बाउंड स्क्रिप्ट, ऐसे ऐड-ऑन होते हैं जिन्हें पब्लिश नहीं किया जाता.

ये सिर्फ़ उस फ़ाइल के लिए काम करते हैं जिससे इन्हें बाइंड किया गया है.

बाउंड स्क्रिप्ट बनाना

Google Docs, Sheets या Slides

Google Docs, Sheets या Slides में बाउंड स्क्रिप्ट बनाने के लिए, Docs में कोई दस्तावेज़, Sheets में कोई स्प्रेडशीट या Slides में कोई प्रज़ेंटेशन खोलें. इसके बाद, एक्सटेंशन > Apps Script पर क्लिक करें. स्क्रिप्ट को बाद में फिर से खोलने के लिए, यही तरीका अपनाएं या Apps Script डैशबोर्ड से स्क्रिप्ट खोलें.

Google Forms

Google फ़ॉर्म में बाउंड स्क्रिप्ट बनाने के लिए, कोई फ़ॉर्म खोलें और ज़्यादा > स्क्रिप्ट एडिटर पर क्लिक करें. स्क्रिप्ट को बाद में फिर से खोलने के लिए, यही तरीका अपनाएं या Apps Script डैशबोर्ड से स्क्रिप्ट खोलें.

ध्यान दें: clasp टूल, बाउंड स्क्रिप्ट नहीं बना सकता. हालांकि, यह उन्हें क्लोन और उनमें बदलाव कर सकता है.

खास तरीके

बाउंड स्क्रिप्ट, कुछ ऐसे तरीकों को कॉल कर सकती हैं जिन्हें स्टैंडअलोन स्क्रिप्ट कॉल नहीं कर सकतीं:

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation(), और getActiveForm() की मदद से, बाउंड स्क्रिप्ट अपनी पैरंट फ़ाइल को फ़ाइल के आईडी का इस्तेमाल किए बिना ऐक्सेस कर सकती हैं.
• getUi की मदद से, बाउंड स्क्रिप्ट अपनी पैरंट फ़ाइल के यूज़र इंटरफ़ेस को ऐक्सेस कर सकती हैं. इससे वे कस्टम मेन्यू, डायलॉग, और साइडबार जोड़ सकती हैं.
• Google Sheets में, getActiveSheet(), getActiveRange(), और getActiveCell() की मदद से, स्क्रिप्ट को उपयोगकर्ता की मौजूदा शीट, चुनी गई सेल की रेंज या चुनी गई अलग-अलग सेल का पता लगाने की अनुमति दें. setActiveSheet(sheet) और setActiveRange(range) पर क्लिक करके, स्क्रिप्ट को उन विकल्पों में बदलाव करने की अनुमति दें.
• Google Docs में, getActiveTab(), getCursor(), और getSelection() की मदद से, स्क्रिप्ट को उपयोगकर्ता के मौजूदा टैब, कर्सर की जगह या चुने गए टेक्स्ट का पता लगाने की अनुमति दें. setActiveTab(tabId), setCursor(position) और setSelection(range) को स्क्रिप्ट के ज़रिए बदलने की अनुमति दें.

ज़्यादा जानकारी के लिए, Google Sheets को एक्सटेंड करने की गाइड या Google Docs को एक्सटेंड करने की गाइड देखें.

ध्यान दें: ये तरीके सिर्फ़ उन बाउंड स्क्रिप्ट के लिए उपलब्ध हैं जिन्हें स्क्रिप्ट एडिटर, मेन्यू आइटम, डायलॉग, साइडबार या ट्रिगर से चलाया जाता है. जब किसी बाउंड स्क्रिप्ट को वेब ऐप्लिकेशन के तौर पर या Apps Script API के ज़रिए चलाया जाता है, तब ये तरीके उपलब्ध नहीं होते.

कस्टम मेन्यू, डायलॉग, और साइडबार

बाउंड स्क्रिप्ट, Google Sheets, Docs, और Forms को अपनी पसंद के मुताबिक बना सकती हैं. इसके लिए, वे कस्टम मेन्यू और डायलॉग बॉक्स या साइडबार जोड़ सकती हैं. हालांकि, ध्यान रखें कि कोई स्क्रिप्ट सिर्फ़ खुली हुई फ़ाइल के मौजूदा इंस्टेंस के यूज़र इंटरफ़ेस से इंटरैक्ट कर सकती है. इसका मतलब है कि किसी एक दस्तावेज़ से जुड़ी स्क्रिप्ट, दूसरे दस्तावेज़ के यूज़र इंटरफ़ेस पर असर नहीं डाल सकती.

ऐड-ऑन, कस्टम मेन्यू, डायलॉग, और साइडबार भी जोड़ सकते हैं. हमारा सुझाव है कि ऐड-ऑन बनाने के लिए, स्टैंडअलोन स्क्रिप्ट का इस्तेमाल करें.

ट्रिगर

बाउंड स्क्रिप्ट, सिंपल ट्रिगर का इस्तेमाल कर सकती हैं. जैसे, खास onOpen() फ़ंक्शन. यह फ़ंक्शन, फ़ाइल को ऐसे उपयोगकर्ता के ज़रिए खोले जाने पर अपने-आप चलता है जिसके पास फ़ाइल में बदलाव करने का ऐक्सेस होता है. सभी तरह की स्क्रिप्ट की तरह, ये स्क्रिप्ट भी इंस्टॉल किए जा सकने वाले ट्रिगर का इस्तेमाल कर सकती हैं.

कस्टम फ़ंक्शन

कस्टम फ़ंक्शन, Google Sheets से जुड़ी स्क्रिप्ट में मौजूद एक फ़ंक्शन होता है. इसे सीधे तौर पर किसी सेल से कॉल किया जाता है. इसके लिए, =myFunctionName() सिंटैक्स का इस्तेमाल किया जाता है. इसलिए, कस्टम फ़ंक्शन, Sheets में मौजूद सैकड़ों बिल्ट-इन फ़ंक्शन जैसे कि AVERAGE या SUM की तरह ही होते हैं. हालांकि, कस्टम फ़ंक्शन के काम करने का तरीका तय करने का अधिकार आपके पास होता है.

बाउंड स्क्रिप्ट का ऐक्सेस

सिर्फ़ वे उपयोगकर्ता, कंटेनर से जुड़ी स्क्रिप्ट चला सकते हैं जिनके पास कंटेनर में बदलाव करने की अनुमति है. जिन लोगों के पास सिर्फ़ देखने का ऐक्सेस होता है वे स्क्रिप्ट एडिटर नहीं खोल सकते. हालांकि, अगर वे कंटेनर फ़ाइल की कॉपी बनाते हैं, तो वे कॉपी के मालिक बन जाते हैं. इसके बाद, वे स्क्रिप्ट की कॉपी देख सकते हैं और उसे चला सकते हैं.

स्क्रिप्ट की कंटेनर फ़ाइल शेयर करने का तरीका जानने के लिए, Google Drive से फ़ाइलें शेयर करना लेख पढ़ें.

कंटेनर से जुड़ी सभी स्क्रिप्ट के लिए, मालिक, दर्शक, और संपादक के ऐक्सेस की सूची एक जैसी होती है. यह सूची, कंटेनर फ़ाइल के लिए तय की जाती है. कंटेनर का मालिक, स्क्रिप्ट प्रोजेक्ट का मालिकाना हक ले लेता है. भले ही, उसे किसी और ने बनाया हो.