Class CacheService
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Service de cache
Le service Cache vous permet d'accéder à un cache pour stocker des données à court terme.
Cette classe vous permet d'obtenir une instance de cache spécifique. Les caches publics sont destinés aux éléments qui ne dépendent pas de l'utilisateur qui accède à votre script. Les caches privés sont destinés aux éléments spécifiques à l'utilisateur, comme les paramètres ou l'activité récente.
Il n'est pas garanti que les données que vous écrivez dans le cache persistent jusqu'à la date d'expiration. Vous devez être prêt à récupérer null à partir de toutes les lectures.
Documentation détaillée
getDocumentCache()
Récupère l'instance de cache limitée au document et au script actuels. Les caches de documents sont spécifiques au document actuel qui contient le script. Utilisez-les pour stocker des informations de script spécifiques au document en cours. Si cette méthode est appelée en dehors du contexte d'un document contenant (par exemple, à partir d'un script autonome ou d'une application Web), elle renvoie null.
// Gets a cache that is specific to the current document containing the script
const cache = CacheService.getDocumentCache();
Renvois
Cache : instance de cache de document ou null en l'absence de document contenant
getScriptCache()
Récupère l'instance de cache limitée au script. Les caches de script sont communs à tous les utilisateurs du script. Utilisez-les pour stocker des informations qui ne sont pas spécifiques à l'utilisateur actuel.
// Gets a cache that is common to all users of the script
const cache = CacheService.getScriptCache();
Renvois
Cache : instance de cache de script
getUserCache()
Récupère l'instance de cache limitée à l'utilisateur et au script actuels. Les caches utilisateur sont spécifiques à l'utilisateur actuel du script. Utilisez-les pour stocker des informations de script spécifiques à l'utilisateur actuel.
// Gets a cache that is specific to the current user of the script
const cache = CacheService.getUserCache();
Renvois
Cache : instance de cache utilisateur
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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"]]
