Cache Service
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Pamięć podręczna
Ta usługa umożliwia skryptowi tymczasowe przechowywanie w pamięci podręcznej wyników, których pobranie lub obliczenie zajmuje dużo czasu. Pamięć podręczna publiczna służy do przechowywania informacji, które nie zależą od tego, który użytkownik uzyskuje dostęp do skryptu. Pamięć podręczna prywatna służy do przechowywania danych związanych z konkretnym użytkownikiem, takich jak ustawienia czy ostatnia aktywność.
Zajęcia
| Nazwa | Krótki opis |
Cache | Odwołanie do konkretnej pamięci podręcznej. |
CacheService | CacheService umożliwia dostęp do pamięci podręcznej na potrzeby krótkotrwałego przechowywania danych. |
Metody
| Metoda | Zwracany typ | Krótki opis |
get(key) | String | Pobiera wartość z poziomu pamięci podręcznej dla danego klucza lub null, jeśli nie znaleziono żadnej wartości. |
getAll(keys) | Object | Zwraca obiekt JavaScript zawierający wszystkie pary klucz-wartość znalezione w pamięci podręcznej dla tablicy kluczy. |
put(key, value) | void | Dodaje do pamięci podręcznej parę klucz-wartość. |
put(key, value, expirationInSeconds) | void | Dodaje parę klucz-wartość do pamięci podręcznej z czasem wygaśnięcia (w sekundach). |
putAll(values) | void | Dodaje do pamięci podręcznej zestaw par klucz-wartość. |
putAll(values, expirationInSeconds) | void | Dodaje do pamięci podręcznej zestaw par klucz-wartość z czasem wygaśnięcia (w sekundach). |
remove(key) | void | Usuwa wpis z pamięci podręcznej przy użyciu podanego klucza. |
removeAll(keys) | void | Usuwa z pamięci podręcznej zbiór wpisów. |
Metody
| Metoda | Zwracany typ | Krótki opis |
getDocumentCache() | Cache | Pobiera instancję pamięci podręcznej ograniczoną do bieżącego dokumentu i skryptu. |
getScriptCache() | Cache | Pobiera instancję pamięci podręcznej ograniczoną do skryptu. |
getUserCache() | Cache | Pobiera instancję pamięci podręcznej ograniczoną do bieżącego użytkownika i skryptu. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
