Class CacheService
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Servicio de caché
El servicio de caché te permite acceder a una caché para el almacenamiento de datos a corto plazo.
Esta clase te permite obtener una instancia de caché específica. Las cachés públicas son para elementos que no dependen del usuario que accede a tu secuencia de comandos. Las cachés privadas son para elementos específicos del usuario, como la configuración o la actividad reciente.
No se garantiza que los datos que escribas en la caché persistan hasta el tiempo de vencimiento. Debes estar preparado para recuperar null de todas las lecturas.
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
getDocumentCache() | Cache | Obtiene la instancia de caché centrada en el documento y la secuencia de comandos actuales. |
getScriptCache() | Cache | Obtiene la instancia de caché centrada en la secuencia de comandos. |
getUserCache() | Cache | Obtiene la instancia de caché centrada en el usuario y la secuencia de comandos actuales. |
Documentación detallada
getDocumentCache()
Obtiene la instancia de caché centrada en el documento y la secuencia de comandos actuales. Las cachés de documentos son específicas del documento actual que contiene la secuencia de comandos. Úsalos para almacenar información de la secuencia de comandos que sea específica del documento actual. Si se llama a este método fuera del contexto de un documento que lo contiene (como desde una secuencia de comandos independiente o una app web), este método muestra null.
// Gets a cache that is specific to the current document containing the script
const cache = CacheService.getDocumentCache();
Volver
Cache: Es una instancia de caché de documentos o null si no hay un documento contenedor.
getScriptCache()
Obtiene la instancia de caché centrada en la secuencia de comandos. Las cachés de secuencias de comandos son comunes para todos los usuarios de la
secuencia de comandos. Úsalos para almacenar información que no sea específica del usuario actual.
// Gets a cache that is common to all users of the script
const cache = CacheService.getScriptCache();
Volver
Cache: Es una instancia de caché de la secuencia de comandos.
getUserCache()
Obtiene la instancia de caché centrada en el usuario y la secuencia de comandos actuales. Las cachés de usuario son específicas para el usuario actual de la secuencia de comandos. Úsalos para almacenar información de secuencias de comandos específica del usuario actual.
// Gets a cache that is specific to the current user of the script
const cache = CacheService.getUserCache();
Volver
Cache: Es una instancia de caché de usuario.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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"]]
