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

किसी स्क्रिप्ट को 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 में, getCursor() और getSelection() स्क्रिप्ट की मदद से, उपयोगकर्ता के कर्सर या चुने गए टेक्स्ट की जगह तय की जाती है. setCursor(position) और setSelection(range) स्क्रिप्ट की मदद से, वे जगहें बदली जा सकती हैं.

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

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

पसंद के मुताबिक मेन्यू, डायलॉग, और साइडबार

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

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

ऐड-ऑन

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

ट्रिगर

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

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

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

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

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

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

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