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