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

किसी स्क्रिप्ट को 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 Forms में बाउंड स्क्रिप्ट बनाने के लिए, कोई फ़ॉर्म खोलें और ज़्यादा > स्क्रिप्ट एडिटर पर क्लिक करें. आने वाले समय में स्क्रिप्ट को फिर से खोलने के लिए, यही तरीका अपनाएं या 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 में अपनी पसंद के मुताबिक बदलाव किए जा सकते हैं. हालांकि, ध्यान रखें कि स्क्रिप्ट सिर्फ़ खुली फ़ाइल के मौजूदा इंस्टेंस के यूज़र इंटरफ़ेस के साथ इंटरैक्ट कर सकती है. इसका मतलब है कि किसी एक दस्तावेज़ से जुड़ी स्क्रिप्ट, किसी दूसरे दस्तावेज़ के यूज़र इंटरफ़ेस पर असर नहीं डाल सकती.

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

ऐड-ऑन

ऐड-ऑन, Gmail, Google Sheets, Docs, Slides, और Forms में काम करते हैं. अगर आपने कोई बाउंड या स्टैंडअलोन स्क्रिप्ट बनाई है और आपको उसे दुनिया के साथ शेयर करना है, तो Apps Script की मदद से अपनी स्क्रिप्ट को ऐड-ऑन के तौर पर पब्लिश किया जा सकता है. इससे दूसरे उपयोगकर्ता, ऐड-ऑन स्टोर से इसे इंस्टॉल कर पाएंगे.

ट्रिगर

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

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

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

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

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

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

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