تتيح لك 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 - نسخة من ذاكرة التخزين المؤقت للمستخدم