CacheService به شما امکان می دهد برای ذخیره کوتاه مدت داده ها به یک کش دسترسی داشته باشید.
این کلاس به شما امکان می دهد یک نمونه کش خاص را دریافت کنید. کش های عمومی برای چیزهایی هستند که بستگی به این ندارند که چه کاربری به اسکریپت شما دسترسی دارد. حافظه پنهان خصوصی برای چیزهایی هستند که مختص کاربر هستند، مانند تنظیمات یا فعالیت اخیر.
داده هایی که در حافظه پنهان می نویسید تا زمان انقضا آن تضمین نمی شود. شما باید آماده باشید که از همه خواندهها null
دریافت کنید.
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
getDocumentCache() | Cache | نمونه حافظه پنهان را به سند و اسکریپت فعلی میرساند. |
getScriptCache() | Cache | نمونه حافظه پنهان را با محدوده اسکریپت دریافت می کند. |
getUserCache() | Cache | نمونه کش را به کاربر فعلی و اسکریپت میرساند. |
مستندات دقیق
getDocumentCache()
نمونه حافظه پنهان را به سند و اسکریپت فعلی میرساند. حافظه پنهان سند مخصوص سند فعلی است که حاوی اسکریپت است. از اینها برای ذخیره اطلاعات اسکریپت که مخصوص سند فعلی است استفاده کنید. اگر این روش خارج از زمینه یک سند حاوی فراخوانی شود (مانند یک اسکریپت مستقل یا برنامه وب)، این روش null
را برمیگرداند.
// Gets a cache that is specific to the current document containing the script var cache = CacheService.getDocumentCache();
بازگشت
Cache
- یک نمونه حافظه پنهان سند، یا اگر سندی حاوی آن وجود نداشته باشد، null
getScriptCache()
نمونه حافظه پنهان را با محدوده اسکریپت دریافت می کند. حافظه پنهان اسکریپت برای همه کاربران اسکریپت مشترک است. از اینها برای ذخیره اطلاعاتی که مختص کاربر فعلی نیست استفاده کنید.
// Gets a cache that is common to all users of the script var cache = CacheService.getScriptCache();
بازگشت
Cache
- یک نمونه کش اسکریپت
getUserCache()
نمونه کش را به کاربر فعلی و اسکریپت میرساند. حافظه پنهان کاربر مختص کاربر فعلی اسکریپت است. از اینها برای ذخیره اطلاعات اسکریپت که مختص کاربر فعلی است استفاده کنید.
// Gets a cache that is specific to the current user of the script var cache = CacheService.getUserCache();
بازگشت
Cache
- یک نمونه کش کاربر