स्क्रिप्ट को किसी एक स्क्रिप्ट, एक स्क्रिप्ट का एक उपयोगकर्ता या एक ऐसे दस्तावेज़ में जिसमें ऐड-ऑन का इस्तेमाल किया जाता है, उसकी-वैल्यू पेयर में सामान्य डेटा स्टोर करने की अनुमति देता है. प्रॉपर्टी को स्क्रिप्ट के बीच शेयर नहीं किया जा सकता. अलग-अलग तरह की प्रॉपर्टी का इस्तेमाल कब करें, इस बारे में ज़्यादा जानकारी के लिए, प्रॉपर्टी सेवा की गाइड देखें.
// Sets three properties of different types. var documentProperties = PropertiesService.getDocumentProperties(); var scriptProperties = PropertiesService.getScriptProperties(); var userProperties = PropertiesService.getUserProperties(); documentProperties.setProperty('DAYS_TO_FETCH', '5'); scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/'); userProperties.setProperty('DISPLAY_UNITS', 'metric');
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
getDocumentProperties() | Properties | इसके लिए प्रॉपर्टी स्टोर मिलता है (सिर्फ़ इस स्क्रिप्ट के लिए) और सभी उपयोगकर्ता इसे ओपन दस्तावेज़, स्प्रेडशीट या फ़ॉर्म से ऐक्सेस कर सकते हैं. |
getScriptProperties() | Properties | ऐसा प्रॉपर्टी स्टोर मिलता है जिसे सभी उपयोगकर्ता ऐक्सेस कर सकते हैं, लेकिन सिर्फ़ इस स्क्रिप्ट में. |
getUserProperties() | Properties | ऐसा प्रॉपर्टी स्टोर मिलता है जिसे सिर्फ़ मौजूदा उपयोगकर्ता ऐक्सेस कर सकता है. वह भी सिर्फ़ इस स्क्रिप्ट में. |
ज़्यादा जानकारी के साथ दस्तावेज़
getDocumentProperties()
इसके लिए प्रॉपर्टी स्टोर मिलता है (सिर्फ़ इस स्क्रिप्ट के लिए) और सभी उपयोगकर्ता इसे ओपन दस्तावेज़, स्प्रेडशीट या फ़ॉर्म से ऐक्सेस कर सकते हैं. यह सिर्फ़ तब उपलब्ध होता है, जब स्क्रिप्ट पब्लिश की गई हो और ऐड-ऑन के तौर पर लागू की गई हो या उसे Google फ़ाइल टाइप से सीमित किया गया हो. दस्तावेज़ की प्रॉपर्टी उपलब्ध न होने पर, यह तरीका null
दिखाता है. किसी स्क्रिप्ट से बनाई गई दस्तावेज़ प्रॉपर्टी को उस स्क्रिप्ट के बाहर ऐक्सेस नहीं किया जा सकता है. यहां तक कि उसी दस्तावेज़ को ऐक्सेस करने वाली दूसरी स्क्रिप्ट भी उन्हें ऐक्सेस नहीं कर सकती हैं.
रिटर्न
Properties
— यह इस स्क्रिप्ट के लिए सिर्फ़ ऐसा प्रॉपर्टी स्टोर होता है जिसे मौजूदा दस्तावेज़ के सभी उपयोगकर्ता ऐक्सेस कर सकते हैं. इसके अलावा, null
अगर स्क्रिप्ट न तो ऐड-ऑन है या न ही Google Workspace फ़ाइल से जुड़ी है
getScriptProperties()
ऐसा प्रॉपर्टी स्टोर मिलता है जिसे सभी उपयोगकर्ता ऐक्सेस कर सकते हैं, लेकिन सिर्फ़ इस स्क्रिप्ट में.
रिटर्न
Properties
— यह एक ऐसा प्रॉपर्टी स्टोर है जिसे स्क्रिप्ट के सभी उपयोगकर्ता ऐक्सेस कर सकते हैं
getUserProperties()
ऐसा प्रॉपर्टी स्टोर मिलता है जिसे सिर्फ़ मौजूदा उपयोगकर्ता ऐक्सेस कर सकता है. वह भी सिर्फ़ इस स्क्रिप्ट में.
रिटर्न
Properties
— यह एक ऐसा प्रॉपर्टी स्टोर है जिसे सिर्फ़ स्क्रिप्ट का मौजूदा उपयोगकर्ता ऐक्सेस कर सकता है