Cache Service
ذاكرة التخزين المؤقت
تسمح هذه الخدمة للنص البرمجي بتخزين النتائج مؤقتًا في ذاكرة التخزين المؤقت، وهي نتائج تستغرق وقتًا في
جلبها أو احتسابها. تكون ذاكرات التخزين المؤقت العامة مخصّصة للعناصر التي لا تعتمد على المستخدم الذي
يصل إلى النص البرمجي. وتكون ذاكرات التخزين المؤقت الخاصة مخصّصة للعناصر الخاصة بالمستخدم،
مثل الإعدادات أو الأنشطة الحديثة.
صفوف
الاسم | وصف قصير |
Cache | مرجع إلى ذاكرة تخزين مؤقت معيّنة. |
CacheService | ذاكرة التخزين المؤقتتسمح لك الخدمة بالوصول إلى ذاكرة تخزين مؤقت لتخزين البيانات على المدى القصير. |
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
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 | تزيل مجموعة من الإدخالات من ذاكرة التخزين المؤقت. |
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
getDocumentCache() | Cache | تحصل على مثيل ذاكرة التخزين المؤقت الذي يشمل المستند والنص البرمجي الحاليَين. |
getScriptCache() | Cache | تحصل على مثيل ذاكرة التخزين المؤقت على مستوى النص البرمجي. |
getUserCache() | Cache | تحصل على مثيل ذاكرة التخزين المؤقت على مستوى المستخدم والنص البرمجي الحاليَين. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Apps Script Cache service provides temporary storage for script results, improving performance by avoiding redundant computations or fetches."],["Two types of caches are available: public caches for shared data and private caches for user-specific information."],["`CacheService` offers methods to access document, script, or user-scoped caches, while the `Cache` class provides methods for data manipulation within a cache instance, like adding, retrieving, and removing entries."],["Cache entries can have optional expiration times, allowing for automatic removal after a specified duration."]]],[]]