प्रॉपर्टी सेवा की मदद से, सामान्य डेटा को एक स्क्रिप्ट, स्क्रिप्ट के एक उपयोगकर्ता या एक ऐसे दस्तावेज़ में सेव किया जा सकता है जिसमें ऐड-ऑन का इस्तेमाल किया जाता है. आम तौर पर, इसका इस्तेमाल डेवलपर कॉन्फ़िगरेशन या उपयोगकर्ता की प्राथमिकताओं को सेव करने के लिए किया जाता है. प्रॉपर्टी को स्क्रिप्ट के बीच कभी शेयर नहीं किया जाता.
प्रॉपर्टी से जुड़ी सेवाओं के लिए, हर दिन का कोटा और स्टोरेज की सीमाएं देखने के लिए, Google की सेवाओं के लिए कोटा देखें.
प्रॉपर्टी स्टोर की तुलना
PropertiesService
ग्लोबल ऑब्जेक्ट तीन तरीके देता है. इनमें से हर एक तरीका एक जैसा Properties
ऑब्जेक्ट दिखाता है, लेकिन ऐक्सेस के अलग-अलग अधिकार मिलते हैं, जैसा कि इस टेबल में दिखाया गया है:
स्क्रिप्ट गुण | उपयोगकर्ता प्रॉपर्टी | दस्तावेज़ गुण | |
---|---|---|---|
ऐक्सेस करने का तरीका | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
इनके बीच डेटा शेयर किया गया | किसी स्क्रिप्ट, ऐड-ऑन या वेब ऐप्लिकेशन के सभी उपयोगकर्ता | किसी स्क्रिप्ट, ऐड-ऑन या वेब ऐप्लिकेशन का मौजूदा उपयोगकर्ता | खुले हुए दस्तावेज़ में ऐड-ऑन के सभी उपयोगकर्ता |
आम तौर पर इनके लिए इस्तेमाल होता है | पूरे ऐप्लिकेशन का कॉन्फ़िगरेशन डेटा, जैसे कि डेवलपर के बाहरी डेटाबेस का उपयोगकर्ता नाम और पासवर्ड | उपयोगकर्ता के हिसाब से सेटिंग, जैसे कि मेट्रिक या इंपीरियल यूनिट | दस्तावेज़ से जुड़ा डेटा, जैसे कि एम्बेड किए गए चार्ट का सोर्स यूआरएल |
डेटा फ़ॉर्मैट
प्रॉपर्टी सेवा, सभी डेटा को की-वैल्यू पेयर में स्ट्रिंग के तौर पर सेव करती है. जो डेटा टाइप पहले से स्ट्रिंग नहीं हैं वे अपने-आप स्ट्रिंग में बदल जाते हैं. इनमें, सेव किए गए ऑब्जेक्ट में मौजूद तरीके भी शामिल हैं.
डेटा सेव किया जा रहा है
किसी एक वैल्यू को सेव करने के लिए, सही स्टोर के तरीके Properties.setProperty(key,
value)
को कॉल करें, जैसा कि इस उदाहरण में दिखाया गया है:
एक साथ डेटा सेव करने के लिए, की-वैल्यू पेयर के मैप को
Properties.setProperties(properties)
पर पास करें.
पैरामीटर में, ऑब्जेक्ट के हर की-वैल्यू पेयर को एक अलग प्रॉपर्टी के तौर पर सेव किया जाता है:
पढ़ने से जुड़ा डेटा
पहले से सेव की गई किसी वैल्यू को वापस पाने के लिए, Properties.getProperty(key)
को कॉल करें:
मौजूदा प्रॉपर्टी स्टोर में सभी वैल्यू वापस पाने के लिए, Properties.getProperties()
को कॉल करें:
डेटा में बदलाव किया जा रहा है
getProperty()
और getProperties()
तरीके, सेव किए गए डेटा की कॉपी दिखाते हैं, न कि लाइव व्यू की. इसलिए, ऑब्जेक्ट को बदलने पर प्रॉपर्टी स्टोर में वैल्यू अपडेट नहीं होगी. स्टोर में डेटा अपडेट करने के लिए, बस इसे फिर से सेव करें:
डेटा हटाना
कोई एक वैल्यू मिटाने के लिए, Properties.deleteProperty(key)
को कॉल करें:
मौजूदा स्टोर की सभी प्रॉपर्टी मिटाने के लिए, Properties.deleteAllProperties()
को कॉल करें:
स्क्रिप्ट प्रॉपर्टी को मैन्युअल रूप से मैनेज करना
प्रोजेक्ट के सेटिंग पेज पर जाकर, की-वैल्यू पेयर में स्ट्रिंग के तौर पर ज़्यादा से ज़्यादा पचास कस्टम प्रॉपर्टी मैन्युअल तौर पर जोड़ी जा सकती हैं. पचास से ज़्यादा प्रॉपर्टी जोड़ने के लिए, आपको ऊपर डेटा सेव करना में बताए गए तरीकों का इस्तेमाल करके उन्हें प्रोग्राम के ज़रिए जोड़ना होगा. प्रोजेक्ट सेटिंग पेज से स्क्रिप्ट प्रॉपर्टी सेट करने पर, स्क्रिप्ट वैरिएबल का रेफ़रंस नहीं दिया जा सकता.
स्क्रिप्ट प्रॉपर्टी जोड़ें
- अपना Apps Script प्रोजेक्ट खोलें.
- बाईं ओर, प्रोजेक्ट सेटिंग
पर क्लिक करें.
- पहली प्रॉपर्टी जोड़ने के लिए, स्क्रिप्ट प्रॉपर्टी में जाकर स्क्रिप्ट प्रॉपर्टी जोड़ें पर क्लिक करें.
- दूसरी और उसके बाद की प्रॉपर्टी जोड़ने के लिए, स्क्रिप्ट प्रॉपर्टी में जाकर स्क्रिप्ट प्रॉपर्टी में बदलाव करें > स्क्रिप्ट प्रॉपर्टी जोड़ें पर क्लिक करें.
- प्रॉपर्टी के लिए, कुंजी का नाम डालें.
- वैल्यू के लिए, कुंजी की वैल्यू डालें.
- (ज़रूरी नहीं) ज़्यादा प्रॉपर्टी जोड़ने के लिए, स्क्रिप्ट प्रॉपर्टी जोड़ें पर क्लिक करें.
- स्क्रिप्ट प्रॉपर्टी सेव करें पर क्लिक करें.
स्क्रिप्ट की प्रॉपर्टी में बदलाव करें
- अपना Apps Script प्रोजेक्ट खोलें.
- बाईं ओर, प्रोजेक्ट सेटिंग
पर क्लिक करें.
- स्क्रिप्ट प्रॉपर्टी में जाकर, स्क्रिप्ट प्रॉपर्टी में बदलाव करें पर क्लिक करें.
- हर उस प्रॉपर्टी के मुख्य नाम और मुख्य वैल्यू में बदलाव करें जिसे बदलना है.
- स्क्रिप्ट प्रॉपर्टी सेव करें पर क्लिक करें.
स्क्रिप्ट प्रॉपर्टी मिटाएं
- अपना Apps Script प्रोजेक्ट खोलें.
- बाईं ओर, प्रोजेक्ट सेटिंग
पर क्लिक करें.
- स्क्रिप्ट प्रॉपर्टी में जाकर, स्क्रिप्ट प्रॉपर्टी में बदलाव करें पर क्लिक करें.
- जिस प्रॉपर्टी को मिटाना है उसके बगल में मौजूद, हटाएं पर क्लिक करें.
- स्क्रिप्ट प्रॉपर्टी सेव करें पर क्लिक करें.