Cache Service

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

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

الدروس

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

Cache

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
get(key)Stringتعرض هذه الطريقة القيمة المخزّنة مؤقتًا للمفتاح المحدّد، أو null إذا لم يتم العثور على أي قيمة.
getAll(keys)Objectتعرض هذه الطريقة عنصر JavaScript يحتوي على جميع أزواج المفاتيح والقيم التي تم العثور عليها في ذاكرة التخزين المؤقت لمصفوفة من المفاتيح.
put(key, value)voidتضيف هذه الطريقة زوج مفتاح/قيمة إلى ذاكرة التخزين المؤقت.
put(key, value, expirationInSeconds)voidتضيف هذه السمة زوج مفتاح/قيمة إلى ذاكرة التخزين المؤقت، مع تحديد وقت انتهاء الصلاحية (بالثواني).
putAll(values)voidتضيف هذه الطريقة مجموعة من أزواج المفاتيح/القيم إلى ذاكرة التخزين المؤقت.
putAll(values, expirationInSeconds)voidتضيف هذه السمة مجموعة من أزواج المفاتيح والقيم إلى ذاكرة التخزين المؤقت، مع تحديد وقت انتهاء الصلاحية (بالثواني).
remove(key)voidيزيل هذا الإجراء إدخالاً من ذاكرة التخزين المؤقت باستخدام المفتاح المحدّد.
removeAll(keys)voidتزيل هذه الطريقة مجموعة من الإدخالات من ذاكرة التخزين المؤقت.

CacheService

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
getDocumentCache()Cache|nullتعرض هذه الطريقة مثيلاً لذاكرة التخزين المؤقت ضمن نطاق المستند والبرنامج النصي الحاليين.
getScriptCache()Cacheتعرض هذه السمة مثيل ذاكرة التخزين المؤقت الذي يقتصر نطاقه على النص البرمجي.
getUserCache()Cacheتعرض هذه الدالة مثيل ذاكرة التخزين المؤقت على مستوى المستخدم والبرنامج النصي الحاليين.