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

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

Google Forms

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

खास तरीके

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

  • 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 के ज़्यादा वर्शन बनाने के लिए गाइड देखें.

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

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

ऐड-ऑन

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

ट्रिगर

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

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

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

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

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

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