Class Cache

快取

特定快取的參照。

這個類別可讓您在快取中插入、擷取及移除項目。當您需要經常存取昂貴或速度緩慢的資源時，這項功能就特別實用。舉例來說，假設您在 example.com 上有一個 RSS 動態消息，需要 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。
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');

參數

名稱類型說明
keyString在快取中查詢的鍵

回攻員

String：快取的值，如果找不到任何值，則傳回空值

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' would be: {'foo': 'somevalue', 'x': 'othervalue'}

參數

名稱類型說明
keysString[]要查詢的鍵

回攻員

Object：JavaScript 物件，其中包含快取中所有鍵的鍵/值組合

另請參閱

put(key, value)

將鍵/值組合新增至快取。

鍵的長度上限為 250 個半形字元。每個鍵可儲存的資料量上限為 100 KB。這個值會在 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');

參數

名稱類型說明
keyString值的儲存鍵
valueString要快取的值

put(key, value, expirationInSeconds)

將鍵/值組合新增至快取，並附上到期時間 (以秒為單位)。

鍵的長度上限為 250 個半形字元。每個鍵可儲存的資料量上限為 100 KB。指定的到期時間只是建議，如果快取的資料量太多，系統可能會在到期時間前移除快取資料。

快取項目的上限為 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);

參數

名稱類型說明
keyString值的儲存鍵
valueString要快取的值
expirationInSecondsInteger值在快取中保留的最大時間 (以秒為單位)。最小值為 1 秒，最大值為 21600 秒 (6 小時)。

putAll(values)

將一組鍵/值組合新增至快取。

與重複呼叫「put」類似，但效率更高，因為只需要對 memcache 伺服器發出一次呼叫即可設定所有值。鍵的長度上限為 250 個半形字元。每個索引鍵可儲存的資料量上限為 100 KB。值會在 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);

參數

名稱類型說明
valuesObject含有字串鍵和值的 JavaScript 物件

另請參閱

putAll(values, expirationInSeconds)

將一組鍵/值組合加入快取，並設定到期時間 (以秒為單位)。

與重複呼叫「put」類似，但效率更高，因為只需要對 memcache 伺服器發出一次呼叫即可設定所有值。鍵的長度上限為 250 個半形字元。每個索引鍵可儲存的資料量上限為 100 KB。指定的到期時間只是建議，如果快取的資料量太多，系統可能會在到期時間前移除快取資料。

快取項目的上限為 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);

參數

名稱類型說明
valuesObject含有字串鍵和值的 JavaScript 物件
expirationInSecondsInteger值在快取中保留的最大時間 (以秒為單位)。最小允許到期時間為 1 秒，最大允許到期時間為 21600 秒 (6 小時)。預設到期時間為 600 秒 (10 分鐘)。

另請參閱

remove(key)

使用指定鍵從快取中移除項目。

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

參數

名稱類型說明
keyString要從快取中移除的鍵

removeAll(keys)

從快取中移除一組項目。

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

參數

名稱類型說明
keysString[]要移除的鍵陣列