Class CacheService

CacheService

تتيح لك خدمة ذاكرة التخزين المؤقت الوصول إلى ذاكرة تخزين مؤقت لتخزين البيانات على المدى القصير.

تتيح لك هذه الفئة الحصول على مثيل محدّد لذاكرة التخزين المؤقت. تُستخدَم ذاكرات التخزين المؤقت العامة لتخزين البيانات التي لا تعتمد على المستخدم الذي يصل إلى النص البرمجي. تُستخدم ذاكرات التخزين المؤقت الخاصة في تخزين البيانات الخاصة بالمستخدم، مثل الإعدادات أو النشاط الحديث.

لا يمكن ضمان استمرار البيانات التي تكتبها في ذاكرة التخزين المؤقت حتى وقت انتهاء صلاحيتها. يجب أن تكون مستعدًا لاسترداد null من جميع القراءات.

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
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: مثيل لذاكرة التخزين المؤقت للمستخدم