Class CacheService

CacheService

‫CacheService מאפשר לכם לגשת למטמון לאחסון נתונים לטווח קצר.

המחלקות האלה מאפשרות לכם לקבל מופע מטמון ספציפי. מטמון ציבורי מיועד לפריטים שלא תלויים במשתמש שניגש לסקריפט. מטמון פרטי מיועד לפריטים שספציפיים למשתמש, כמו הגדרות או פעילות אחרונה.

אין ערובה לכך שהנתונים שכותבים למטמון יישארו בו עד לתפוגה שלהם. אתם צריכים להיות מוכנים לקבל null מכל הקריאות.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
getDocumentCache()Cache|nullהפונקציה מחזירה את מופע המטמון שמוגדר במסגרת המסמך והסקריפט הנוכחיים.
getScriptCache()Cacheהפונקציה מחזירה את מופע המטמון שמוגדר לסקריפט.
getUserCache()Cacheמחזירה את מופע המטמון שמוגדר בהיקף המשתמש והסקריפט הנוכחיים.

תיעוד מפורט

getDocumentCache()

הפונקציה מחזירה את מופע המטמון שמוגדר במסגרת המסמך והסקריפט הנוכחיים. מטמון המסמכים ספציפי למסמך הנוכחי שמכיל את הסקריפט. הם משמשים לאחסון מידע על הסקריפט שספציפי למסמך הנוכחי. אם קוראים לשיטה הזו מחוץ להקשר של מסמך שמכיל אותה (למשל מסקריפט עצמאי או מאפליקציית אינטרנט), השיטה הזו מחזירה null. 

// Gets a cache that is specific to the current document containing the script
const cache = CacheService.getDocumentCache();

חזרה

‫Cache|null — מופע של מטמון מסמכים, או null אם אין מסמך מכיל.

getScriptCache()

הפונקציה מחזירה את מופע המטמון שמוגדר לסקריפט. מטמון הסקריפט משותף לכל המשתמשים בסקריפט. אפשר להשתמש בהם כדי לאחסן מידע שלא ספציפי למשתמש הנוכחי. 

// Gets a cache that is common to all users of the script
const cache = CacheService.getScriptCache();

חזרה

‫Cache – מופע של מטמון סקריפטים.

getUserCache()

מחזירה את מופע המטמון שמוגדר בהיקף המשתמש והסקריפט הנוכחיים. מטמון המשתמשים ספציפי למשתמש הנוכחי של הסקריפט. אפשר להשתמש בהם כדי לאחסן פרטי סקריפט שספציפיים למשתמש הנוכחי. 

// Gets a cache that is specific to the current user of the script
const cache = CacheService.getUserCache();

חזרה

‫Cache – מופע של מטמון משתמש.