Class CacheService

خدمة ذاكرة التخزين المؤقت

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

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

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

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getDocumentCache()Cacheتحصل على مثيل ذاكرة التخزين المؤقت الذي يشمل المستند والنصوص البرمجية الحالية.
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 في حال عدم توفّر مستند يحتوي على العنصر

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