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