Class Cache

कैश मेमोरी

किसी खास कैश मेमोरी का रेफ़रंस.

इस क्लास की मदद से, कैश मेमोरी में आइटम डाले, वापस पाए, और हटाए जा सकते हैं. यह सुविधा तब खास तौर पर काम आ सकती है, जब आपको किसी महंगे या धीमे संसाधन को बार-बार ऐक्सेस करना हो. उदाहरण के लिए, मान लीजिए कि आपके पास example.com पर एक आरएसएस फ़ीड है, जिसे फ़ेच करने में 20 सेकंड लगते हैं. हालांकि, आपको औसत अनुरोध पर ऐक्सेस करने की प्रोसेस को तेज़ करना है.

function getRssFeed() {
  const cache = CacheService.getScriptCache();
  const cached = cache.get('rss-feed-contents');
  if (cached != null) {
    return cached;
  }
  const result = UrlFetchApp.fetch(
      'http://example.com/my-slow-rss-feed.xml');  // takes 20 seconds
  const contents = result.getContentText();
  cache.put('rss-feed-contents', contents, 1500);  // cache for 25 minutes
  return contents;
}

अगर आइटम कैश मेमोरी में नहीं है, तो आपको अब भी 20 सेकंड तक इंतज़ार करना होगा. हालांकि, इसके बाद के कॉल बहुत तेज़ी से किए जाते हैं. ऐसा तब तक होता है, जब तक आइटम 25 मिनट में कैश मेमोरी से हट नहीं जाता.

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
get(key)	String|null	यह फ़ंक्शन, दी गई कुंजी के लिए कैश मेमोरी में सेव की गई वैल्यू को दिखाता है. अगर कोई वैल्यू नहीं मिलती है, तो null दिखाता है.
getAll(keys)	Object	यह फ़ंक्शन, JavaScript ऑब्जेक्ट दिखाता है. इसमें कुंजियों की ऐरे के लिए, कैश मेमोरी में मौजूद सभी कुंजी/वैल्यू पेयर होते हैं.
put(key, value)	void	यह फ़ंक्शन, कैश मेमोरी में की/वैल्यू पेयर जोड़ता है.
put(key, value, expirationInSeconds)	void	यह फ़ंक्शन, कैश मेमोरी में की/वैल्यू पेयर जोड़ता है. साथ ही, इसके लिए समयसीमा (सेकंड में) तय करता है.
putAll(values)	void	यह फ़ंक्शन, कैश मेमोरी में की/वैल्यू पेयर का सेट जोड़ता है.
putAll(values, expirationInSeconds)	void	यह फ़ंक्शन, की/वैल्यू पेयर के सेट को कैश मेमोरी में जोड़ता है. साथ ही, इसके लिए समयसीमा (सेकंड में) तय करता है.
remove(key)	void	यह फ़ंक्शन, दी गई कुंजी का इस्तेमाल करके कैश मेमोरी से किसी एंट्री को हटाता है.
removeAll(keys)	void	यह कुकी, कैश मेमोरी से एंट्री का सेट हटाती है.

ज़्यादा जानकारी वाला दस्तावेज़

get(key)

यह फ़ंक्शन, दी गई कुंजी के लिए कैश मेमोरी में सेव की गई वैल्यू को दिखाता है. अगर कोई वैल्यू नहीं मिलती है, तो null दिखाता है.

// Gets the value from the cache for the key 'foo'.
const value = CacheService.getScriptCache().get('foo');

पैरामीटर

नाम	टाइप	ब्यौरा
key	String	कैश मेमोरी में खोजने के लिए कुंजी.

वापसी का टिकट

String|null — कैश की गई वैल्यू या अगर कोई वैल्यू नहीं मिली, तो null.

---

getAll(keys)

यह फ़ंक्शन, JavaScript ऑब्जेक्ट दिखाता है. इसमें कुंजियों की ऐरे के लिए, कैश मेमोरी में मौजूद सभी कुंजी/वैल्यू पेयर होते हैं.

// Gets a set of values from the cache
const values = CacheService.getDocumentCache().getAll(['foo', 'x', 'missing']);
// If there were values in the cache for 'foo' and 'x' but not 'missing', then
// 'values' is: {'foo': 'somevalue', 'x': 'othervalue'}

पैरामीटर

नाम	टाइप	ब्यौरा
keys	String[]	खोजने के लिए कुंजियां.

वापसी का टिकट

Object — यह एक JavaScript ऑब्जेक्ट है. इसमें कैश मेमोरी में मिली सभी कुंजियों के लिए, कुंजी/वैल्यू पेयर शामिल होते हैं.

इन्हें भी देखें

• get(key)

---

put(key, value)

यह फ़ंक्शन, कैश मेमोरी में की/वैल्यू पेयर जोड़ता है.

किसी कुंजी में ज़्यादा से ज़्यादा 250 वर्ण हो सकते हैं. हर कुंजी के लिए, ज़्यादा से ज़्यादा 100 केबी डेटा सेव किया जा सकता है. यह वैल्यू, 600 सेकंड (10 मिनट) के बाद कैश मेमोरी से हट जाती है.

कैश किए गए आइटम की सीमा 1,000 है. अगर 1,000 से ज़्यादा आइटम लिखे जाते हैं, तो कैश मेमोरी में ऐसे 900 आइटम सेव होते हैं जिनकी समयसीमा खत्म होने में सबसे ज़्यादा समय बचा है. इस सीमा में बदलाव हो सकता है.

const cache = CacheService.getScriptCache();
// Puts the value 'bar' into the cache using the key 'foo'
cache.put('foo', 'bar');

पैरामीटर

नाम	टाइप	ब्यौरा
key	String	वह कुंजी जिसके तहत वैल्यू को सेव करना है.
value	String	कैश की जाने वाली वैल्यू.

---

put(key, value, expirationInSeconds)

यह फ़ंक्शन, कैश मेमोरी में की/वैल्यू पेयर जोड़ता है. साथ ही, इसके लिए समयसीमा (सेकंड में) तय करता है.

किसी कुंजी में ज़्यादा से ज़्यादा 250 वर्ण हो सकते हैं. हर कुंजी के लिए, ज़्यादा से ज़्यादा 100 केबी डेटा सेव किया जा सकता है. तय की गई समयसीमा सिर्फ़ एक सुझाव है. अगर बहुत सारा डेटा कैश मेमोरी में सेव किया गया है, तो हो सकता है कि कैश मेमोरी में सेव किए गए डेटा को इस समयसीमा से पहले ही हटा दिया जाए.

कैश किए गए आइटम की सीमा 1,000 है. अगर 1,000 से ज़्यादा आइटम लिखे जाते हैं, तो कैश मेमोरी में ऐसे 900 आइटम सेव होते हैं जिनकी समयसीमा खत्म होने में सबसे ज़्यादा समय बचा है. इस सीमा में बदलाव हो सकता है.

// Puts the value 'bar' into the cache using the key 'foo', but only for the
// next 20 seconds.
CacheService.getScriptCache().put('foo', 'bar', 20);

पैरामीटर

नाम	टाइप	ब्यौरा
key	String	वह कुंजी जिसके तहत वैल्यू को सेव करना है.
value	String	कैश की जाने वाली वैल्यू.
expirationInSeconds	Integer	यह वैल्यू, कैश मेमोरी में ज़्यादा से ज़्यादा कितने सेकंड तक सेव रहती है. इंतज़ार करने का समय कम से कम 1 सेकंड और ज़्यादा से ज़्यादा 21,600 सेकंड (6 घंटे) के लिए सेट किया जा सकता है.

---

putAll(values)

यह फ़ंक्शन, कैश मेमोरी में की/वैल्यू पेयर का सेट जोड़ता है.

यह "put" को बार-बार कॉल करने जैसा ही है, लेकिन यह ज़्यादा बेहतर है, क्योंकि यह सिर्फ़ एक बार कॉल करता है. हर कुंजी के लिए, 100 केबी तक का डेटा सेव किया जा सकता है. ये वैल्यू, 600 सेकंड (10 मिनट) के बाद कैश मेमोरी से हट जाती हैं.

कैश किए गए आइटम की सीमा 1,000 है. अगर 1,000 से ज़्यादा आइटम लिखे जाते हैं, तो कैश मेमोरी में ऐसे 900 आइटम सेव होते हैं जिनकी समयसीमा खत्म होने में सबसे ज़्यादा समय बचा है. इस सीमा में बदलाव हो सकता है.

// Puts a set of values into the cache with the keys 'foo', 'x', and 'key'.
const values = {
  foo: 'bar',
  x: 'y',
  key: 'value',
};
CacheService.getUserCache().putAll(values);

पैरामीटर

नाम	टाइप	ब्यौरा
values	Object	यह एक JavaScript ऑब्जेक्ट है. इसमें स्ट्रिंग कुंजियां और वैल्यू शामिल होती हैं.

इन्हें भी देखें

• put(key, value)

---

putAll(values, expirationInSeconds)

यह फ़ंक्शन, की/वैल्यू पेयर के सेट को कैश मेमोरी में जोड़ता है. साथ ही, इसके लिए समयसीमा (सेकंड में) तय करता है.

यह "put" को बार-बार कॉल करने जैसा ही है, लेकिन यह ज़्यादा असरदार है. ऐसा इसलिए, क्योंकि यह सभी वैल्यू सेट करने के लिए, memcache सर्वर को सिर्फ़ एक बार कॉल करता है. किसी कुंजी में ज़्यादा से ज़्यादा 250 वर्ण हो सकते हैं. हर कुंजी के लिए, ज़्यादा से ज़्यादा 100 केबी का डेटा सेव किया जा सकता है. समयसीमा खत्म होने का समय सिर्फ़ एक सुझाव है. अगर बहुत ज़्यादा डेटा को कैश मेमोरी में सेव किया गया है, तो इस समय से पहले भी कैश मेमोरी में सेव किया गया डेटा हटाया जा सकता है.

कैश किए गए आइटम की सीमा 1,000 है. अगर 1,000 से ज़्यादा आइटम लिखे जाते हैं, तो कैश मेमोरी में ऐसे 900 आइटम सेव होते हैं जिनकी समयसीमा खत्म होने में सबसे ज़्यादा समय बचा है. इस सीमा में बदलाव हो सकता है.

// Puts a set of values into the cache with the keys 'foo', 'x', and 'key'.
const values = {
  foo: 'bar',
  x: 'y',
  key: 'value',
};
CacheService.getUserCache().putAll(values, 20);

पैरामीटर

नाम	टाइप	ब्यौरा
values	Object	यह एक JavaScript ऑब्जेक्ट है. इसमें स्ट्रिंग कुंजियां और वैल्यू शामिल होती हैं.
expirationInSeconds	Integer	यह वैल्यू, कैश मेमोरी में ज़्यादा से ज़्यादा कितने सेकंड तक सेव रहेगी. कम से कम एक सेकंड और ज़्यादा से ज़्यादा 21, 600 सेकंड (छह घंटे) तक सेव रहने की अनुमति है. डिफ़ॉल्ट रूप से, कुकी के खत्म होने की अवधि 600 सेकंड (10 मिनट) होती है.

इन्हें भी देखें

• put(key, value)

---

remove(key)

यह फ़ंक्शन, दी गई कुंजी का इस्तेमाल करके कैश मेमोरी से किसी एंट्री को हटाता है.

// Removes any cache entries for 'foo'
CacheService.getUserCache().remove('foo');

पैरामीटर

नाम	टाइप	ब्यौरा
key	String	कैश मेमोरी से हटाने के लिए कुंजी.

---

removeAll(keys)

यह कुकी, कैश मेमोरी से एंट्री का सेट हटाती है.

// Removes entries from the cache with keys 'foo' and 'x'
CacheService.getDocumentCache().removeAll(['foo', 'x']);

पैरामीटर

नाम	टाइप	ब्यौरा
keys	String[]	हटाने के लिए कुंजियों का ऐरे.