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