Class CacheService
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
CacheService
Il servizio Cache ti consente di accedere a una cache per l'archiviazione a breve termine dei dati.
Questa classe ti consente di ottenere un'istanza cache specifica. Le cache pubbliche sono destinate a elementi che non dipendono dall'utente che accede allo script. Le cache private sono destinate a elementi specifici dell'utente, come le impostazioni o le attività recenti.
Non è garantito che i dati scritti nella cache persistano fino alla scadenza. Devi essere preparato a ricevere null da tutte le letture.
Documentazione dettagliata
getDocumentCache()
Recupera l'istanza della cache limitata al documento e allo script correnti. Le cache dei documenti sono specifiche per il documento corrente che contiene lo script. Utilizzali per memorizzare le informazioni dello script specifiche per il documento corrente. Se questo metodo viene chiamato al di fuori del contesto di un
documento contenente (ad esempio da uno script autonomo o da un'app web), restituisce null.
// Gets a cache that is specific to the current document containing the script
const cache = CacheService.getDocumentCache();
Invio
Cache: un'istanza della cache dei documenti o null se non esiste un documento contenitore
getScriptCache()
Recupera l'istanza della cache limitata allo script. Le cache dello script sono comuni a tutti gli utenti dello script. Utilizzali per memorizzare informazioni non specifiche per l'utente corrente.
// Gets a cache that is common to all users of the script
const cache = CacheService.getScriptCache();
Invio
Cache: un'istanza della cache dello script
getUserCache()
Recupera l'istanza della cache basata sull'utente e sullo script correnti. Le cache utente sono specifiche per l'utente corrente dello script. Utilizzali per memorizzare informazioni sullo script specifiche per l'utente corrente.
// Gets a cache that is specific to the current user of the script
const cache = CacheService.getUserCache();
Invio
Cache: un'istanza della cache utente
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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"]]
