Cache Service
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cache
Esse serviço permite que um script armazene em cache temporariamente resultados que demoram para
ser buscados/calculados. Os caches públicos são para coisas que não dependem de qual usuário
está acessando o script. Os caches privados são usados para coisas específicas do usuário,
como configurações ou atividades recentes.
Classes
Nome | Breve descrição |
Cache | Uma referência a um cache específico. |
CacheService | O serviço de cache permite acessar um cache para armazenamento de dados de curto prazo. |
Métodos
Método | Tipo de retorno | Breve descrição |
get(key) | String | Recebe o valor armazenado em cache para a chave especificada ou null se nenhuma for encontrada. |
getAll(keys) | Object | Retorna um objeto JavaScript contendo todos os pares de chave-valor encontrados no cache para uma matriz de
chaves. |
put(key, value) | void | Adiciona um par de chave-valor ao cache. |
put(key, value, expirationInSeconds) | void | Adiciona um par de chave-valor ao cache com um tempo de expiração (em segundos). |
putAll(values) | void | Adiciona um conjunto de pares de chave-valor ao cache. |
putAll(values, expirationInSeconds) | void | Adiciona um conjunto de pares de chave-valor ao cache com um tempo de expiração (em segundos). |
remove(key) | void | Remove uma entrada do cache usando a chave especificada. |
removeAll(keys) | void | Remove um conjunto de entradas do cache. |
Métodos
Método | Tipo de retorno | Breve descrição |
getDocumentCache() | Cache | Recebe a instância de cache com o escopo definido para o documento e o script atuais. |
getScriptCache() | Cache | Extrai a instância de cache com escopo definido para o script. |
getUserCache() | Cache | Recebe a instância de cache com escopo definido para o usuário e o script atuais. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eApps Script Cache service provides temporary storage for script results, improving performance by avoiding redundant computations or fetches.\u003c/p\u003e\n"],["\u003cp\u003eTwo types of caches are available: public caches for shared data and private caches for user-specific information.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCacheService\u003c/code\u003e offers methods to access document, script, or user-scoped caches, while the \u003ccode\u003eCache\u003c/code\u003e class provides methods for data manipulation within a cache instance, like adding, retrieving, and removing entries.\u003c/p\u003e\n"],["\u003cp\u003eCache entries can have optional expiration times, allowing for automatic removal after a specified duration.\u003c/p\u003e\n"]]],[],null,["# Cache Service\n\nCache\n\nThis service allows a script to temporarily cache results that take time to\nfetch/compute. Public caches are for things that are not dependent on which user\nis accessing your script. Private caches are for things which are user-specific,\nlike settings or recent activity.\n\nClasses\n-------\n\n| Name | Brief description |\n|------------------------------------------------------------|---------------------------------------------------------------------------|\n| [Cache](/apps-script/reference/cache/cache) | A reference to a particular cache. |\n| [CacheService](/apps-script/reference/cache/cache-service) | CacheService allows you to access a cache for short term storage of data. |\n\n[Cache](/apps-script/reference/cache/cache)\n-------------------------------------------\n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------------------------------------------------|-------------|-----------------------------------------------------------------------------------------------------|\n| [get(key)](/apps-script/reference/cache/cache#get(String)) | `String` | Gets the cached value for the given key, or `null` if none is found. |\n| [getAll(keys)](/apps-script/reference/cache/cache#getAll(String)) | `Object` | Returns a JavaScript Object containing all key/value pairs found in the cache for an array of keys. |\n| [put(key, value)](/apps-script/reference/cache/cache#put(String,String)) | `void` | Adds a key/value pair to the cache. |\n| [put(key, value, expirationInSeconds)](/apps-script/reference/cache/cache#put(String,String,Integer)) | `void` | Adds a key/value pair to the cache, with an expiration time (in seconds). |\n| [putAll(values)](/apps-script/reference/cache/cache#putAll(Object)) | `void` | Adds a set of key/value pairs to the cache. |\n| [putAll(values, expirationInSeconds)](/apps-script/reference/cache/cache#putAll(Object,Integer)) | `void` | Adds a set of key/value pairs to the cache, with an expiration time (in seconds). |\n| [remove(key)](/apps-script/reference/cache/cache#remove(String)) | `void` | Removes an entry from the cache using the given key. |\n| [removeAll(keys)](/apps-script/reference/cache/cache#removeAll(String)) | `void` | Removes a set of entries from the cache. |\n\n[CacheService](/apps-script/reference/cache/cache-service)\n----------------------------------------------------------\n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------------------------------|---------------------------------------------|--------------------------------------------------------------------|\n| [getDocumentCache()](/apps-script/reference/cache/cache-service#getDocumentCache()) | [Cache](/apps-script/reference/cache/cache) | Gets the cache instance scoped to the current document and script. |\n| [getScriptCache()](/apps-script/reference/cache/cache-service#getScriptCache()) | [Cache](/apps-script/reference/cache/cache) | Gets the cache instance scoped to the script. |\n| [getUserCache()](/apps-script/reference/cache/cache-service#getUserCache()) | [Cache](/apps-script/reference/cache/cache) | Gets the cache instance scoped to the current user and script. |"]]