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

किसी स्क्रिप्ट को 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 डैशबोर्ड से स्क्रिप्ट खोलें.

खास तरीके

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

  • 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 का इस्तेमाल करने के बारे में गाइड देखें.

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

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

ऐड-ऑन

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

ट्रिगर

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

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

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

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

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

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