Properties Service

المواقع

تسمح هذه الخدمة للنصوص البرمجية بتخزين السلاسل كأزواج مفتاح/قيمة على مستوى نص برمجي واحد أو مستخدم واحد للنص البرمجي أو مستند واحد يتم فيه استخدام إضافة محرِّر. لمزيد من المعلومات عن حالات استخدام كل نوع من المواقع، اطّلِع على دليل خدمة المواقع.

صفوف

الاسموصف قصير
Propertiesيعمل عنصر "الخصائص" كواجهة للوصول إلى خصائص المستخدِم أو المستند أو النص البرمجي.
PropertiesServiceيسمح للنصوص البرمجية بتخزين بيانات بسيطة في أزواج مفتاح/قيمة على مستوى نص برمجي واحد أو مستخدم واحد لنص برمجي أو مستند واحد يتم فيه استخدام إحدى الإضافات.
ScriptPropertiesسمات النصوص البرمجية هي أزواج مفتاح/قيمة يخزّنها نص برمجي في مساحة تخزين دائمة.
UserPropertiesخصائص المستخدِمين هي أزواج مفتاح/قيمة فريدة للمستخدِم.

Properties

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
deleteAllProperties()Propertiesلحذف جميع المواقع في متجر Properties الحالي
deleteProperty(key)Propertiesتؤدي هذه الوظيفة إلى حذف الموقع الذي يحتوي على المفتاح المحدّد في متجر Properties الحالي.
getKeys()String[]تحصل على جميع المفاتيح في متجر Properties الحالي.
getProperties()Objectتحصل على نسخة من جميع أزواج المفتاح/القيمة في متجر Properties الحالي.
getProperty(key)Stringتحصل على القيمة المرتبطة بالمفتاح المحدَّد في متجر Properties الحالي، أو null إذا لم يكن هناك مفتاح من هذا النوع.
setProperties(properties)Propertiesتُستخدَم لضبط جميع أزواج المفتاح/القيمة من العنصر المحدّد في ذاكرة التخزين Properties الحالية.
setProperties(properties, deleteAllOthers)Propertiesتُستخدَم لضبط جميع أزواج المفتاح/القيمة من العنصر المحدّد في متجر Properties الحالي، وحذف جميع السمات الأخرى في المتجر اختياريًا.
setProperty(key, value)Propertiesتُستخدَم لضبط زوج المفتاح/القيمة المحدَّد في متجر Properties الحالي.

PropertiesService

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getDocumentProperties()Propertiesتحصل على متجر موقع (لهذا النص البرمجي فقط) يمكن لجميع المستخدمين الوصول إليه ضمن الجدول المفتوح أو المستند أو النموذج.
getScriptProperties()Propertiesتحصل على متجر مواقع يمكن لجميع المستخدمين الوصول إليه، ولكن ضمن هذا النص البرمجي فقط.
getUserProperties()Propertiesتحصل على متجر خاصيات لا يمكن للمستخدم الحالي الوصول إليه إلا ضمن هذا النص البرمجي.

ScriptProperties

UserProperties