CacheService, verilerin kısa süreli depolanması için bir önbelleğe erişmenize olanak tanır.
Bu sınıf, belirli bir önbellek örneği almanıza olanak tanır. Herkese açık önbellekler, komut dosyanıza hangi kullanıcının eriştiğine bağlı olmayan öğeler içindir. Özel önbellekler, kullanıcıya özel olan öğeler (ör. ayarlar veya son etkinlik) içindir.
Önbelleğe yazdığınız verilerin, geçerlilik süresi sona erene kadar kalıcı olacağı garanti edilmez. Tüm okumalardan null almaya hazır olmanız gerekir.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
get | Cache|null | Önbellek örneğini geçerli doküman ve komut dosyasıyla sınırlandırır. |
get | Cache | Komut dosyası kapsamına alınmış önbellek örneğini alır. |
get | Cache | Mevcut kullanıcı ve komut dosyası kapsamına alınmış önbellek örneğini alır. |
Ayrıntılı belgeler
getDocumentCache()
Önbellek örneğini geçerli doküman ve komut dosyasıyla sınırlandırır. Doküman önbellekleri, komut dosyasını içeren mevcut dokümana özeldir. Bunları, geçerli dokümana özgü komut dosyası bilgilerini saklamak için kullanın. Bu yöntem, kapsayan bir doküman bağlamı dışında (ör. bağımsız bir komut dosyasından veya web uygulamasından) çağrılırsa null değerini döndürür.
// Gets a cache that is specific to the current document containing the script const cache = CacheService.getDocumentCache();
Return
Cache|null: Belge önbelleği örneği veya kapsayan belge yoksa null.
getScriptCache()
Komut dosyası kapsamına alınmış önbellek örneğini alır. Komut dosyası önbellekleri, komut dosyasının tüm kullanıcıları için ortaktır. Bunları, mevcut kullanıcıya özgü olmayan bilgileri depolamak için kullanın.
// Gets a cache that is common to all users of the script const cache = CacheService.getScriptCache();
Return
Cache: Komut dosyası önbelleği örneği.
getUserCache()
Mevcut kullanıcı ve komut dosyası kapsamına alınmış önbellek örneğini alır. Kullanıcı önbellekleri, komut dosyasının mevcut kullanıcısına özeldir. Bunları, geçerli kullanıcıya özel komut dosyası bilgilerini depolamak için kullanın.
// Gets a cache that is specific to the current user of the script const cache = CacheService.getUserCache();
Return
Cache: Kullanıcı önbelleği örneği.