Class CacheService
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
ÖnbellekHizmeti
ÖnbellekHizmeti, 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, ayarlar veya son etkinlik gibi kullanıcıya özgü öğeler içindir.
Önbelleğe yazdığınız verilerin, geçerlilik süresi sona erene kadar kalacağı garanti edilmez. Tüm okumalardan null geri almayı kabul etmeniz gerekir.
Ayrıntılı dokümanlar
getDocumentCache()
Geçerli doküman ve komut dosyasıyla kapsamlı önbellek örneğini alır. Doküman önbellekleri, komut dosyasını içeren mevcut dokümana özeldir. Mevcut belgeye özgü komut dosyası bilgilerini saklamak için bunları kullanın. Bu yöntem, içeren dokümanın bağlamı dışında çağrılırsa (ör. bağımsız bir komut dosyasından veya web uygulamasından) null döndürür.
// Gets a cache that is specific to the current document containing the script
const cache = CacheService.getDocumentCache();
Return
Cache: Bir doküman önbelleği örneği veya kapsayıcı doküman yoksa null
getScriptCache()
Komut dosyasına göre kapsamlandırılmış önbellek örneğini alır. Komut dosyası önbellekleri, komut dosyasının tüm kullanıcıları için ortaktır. Mevcut kullanıcıya özgü olmayan bilgileri saklamak için bunları 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. Mevcut kullanıcıya özgü komut dosyası bilgilerini depolamak için bunları 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
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003eCacheService\u003c/code\u003e provides short-term storage for script data, offering document, script, and user-specific scopes.\u003c/p\u003e\n"],["\u003cp\u003eData stored using \u003ccode\u003eCacheService\u003c/code\u003e is not guaranteed to persist and may return \u003ccode\u003enull\u003c/code\u003e when retrieved.\u003c/p\u003e\n"],["\u003cp\u003eThree cache instances are available: \u003ccode\u003egetDocumentCache()\u003c/code\u003e for document-specific data, \u003ccode\u003egetScriptCache()\u003c/code\u003e for script-wide data, and \u003ccode\u003egetUserCache()\u003c/code\u003e for user-specific data.\u003c/p\u003e\n"],["\u003cp\u003eWhen using \u003ccode\u003egetDocumentCache()\u003c/code\u003e, it returns \u003ccode\u003enull\u003c/code\u003e if called outside a document context (standalone script or web app).\u003c/p\u003e\n"]]],[],null,["# Class CacheService\n\nCacheService\n\nCacheService allows you to access a cache for short term storage of data.\n\nThis class lets you get a specific cache instance. Public caches are for things that are not\ndependent on which user is accessing your script. Private caches are for things which are\nuser-specific, like settings or recent activity.\n\nThe data you write to the cache is not guaranteed to persist until its expiration time. You\nmust be prepared to get back `null` from all reads. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------|---------------------------------------------|--------------------------------------------------------------------|\n| [getDocumentCache()](#getDocumentCache()) | [Cache](/apps-script/reference/cache/cache) | Gets the cache instance scoped to the current document and script. |\n| [getScriptCache()](#getScriptCache()) | [Cache](/apps-script/reference/cache/cache) | Gets the cache instance scoped to the script. |\n| [getUserCache()](#getUserCache()) | [Cache](/apps-script/reference/cache/cache) | Gets the cache instance scoped to the current user and script. |\n\nDetailed documentation\n----------------------\n\n### `get``Document``Cache()`\n\nGets the cache instance scoped to the current document and script. Document caches are specific\nto the current document which contains the script. Use these to store script information that\nis specific to the current document. If this method is called outside of the context of a\ncontaining document (such as from a standalone script or web app), this method returns `null`.\n\n```javascript\n// Gets a cache that is specific to the current document containing the script\nconst cache = CacheService.getDocumentCache();\n```\n\n#### Return\n\n\n[Cache](/apps-script/reference/cache/cache) --- a document cache instance, or `null` if there is no containing document\n\n*** ** * ** ***\n\n### `get``Script``Cache()`\n\nGets the cache instance scoped to the script. Script caches are common to all users of the\nscript. Use these to store information that is not specific to the current user.\n\n```javascript\n// Gets a cache that is common to all users of the script\nconst cache = CacheService.getScriptCache();\n```\n\n#### Return\n\n\n[Cache](/apps-script/reference/cache/cache) --- a script cache instance\n\n*** ** * ** ***\n\n### `get``User``Cache()`\n\nGets the cache instance scoped to the current user and script. User caches are specific to the\ncurrent user of the script. Use these to store script information that is specific to the\ncurrent user.\n\n```javascript\n// Gets a cache that is specific to the current user of the script\nconst cache = CacheService.getUserCache();\n```\n\n#### Return\n\n\n[Cache](/apps-script/reference/cache/cache) --- a user cache instance"]]
