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