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