Cache Service

التخزين المؤقت

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

الدروس

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

Cache

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
get(key)String|nullتحصل على القيمة المخزّنة مؤقتًا للمفتاح المحدّد، أو 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تحصل على مثيل ذاكرة التخزين المؤقت المحدّد نطاقه للمستخدم والنص البرمجي الحاليَين.