تخزّن خدمة الخصائص البيانات في أزواج مفتاح-قيمة ضمن نطاق نص برمجي واحد أو مستخدم واحد لنص برمجي أو مستند واحد يتم فيه استخدام إضافة. ويتم استخدامها عادةً لتخزين إعدادات المطوّر أو الإعدادات المفضّلة للمستخدم. لا تتم مشاركة الخصائص بين النصوص البرمجية مطلقًا.
للاطّلاع على الحصص اليومية وحدود مساحة التخزين لخدمة "المواقع"، يُرجى الاطّلاع على حصص خدمات Google.
مقارنة بين متاجِر المواقع
يوفّر العنصر العام
PropertiesService
ثلاث طرق، يعرض كل منها عنصرًا مشابهًا
Properties
ولكن مع حقوق وصول مختلفة، كما هو موضّح في الجدول التالي:
| خصائص النص البرمجي | خصائص المستخدمين | خصائص المستند | |
|---|---|---|---|
| طريقة الوصول | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
| البيانات المشترَكة بين | جميع مستخدمي نص برمجي أو إضافة أو تطبيق ويب | المستخدم الحالي لنص برمجي أو إضافة أو تطبيق ويب | جميع مستخدمي إضافة في المستند المفتوح |
| يُستخدم عادةً في | بيانات الإعداد على مستوى التطبيق، مثل اسم المستخدم وكلمة المرور لقاعدة البيانات الخارجية الخاصة بالمطوّر | الإعدادات الخاصة بالمستخدم، مثل الوحدات المترية أو الإنجليزية | البيانات الخاصة بالمستند، مثل عنوان URL المصدر لرسم بياني مضمَّن |
تنسيق البيانات
تخزّن خدمة "الخصائص" جميع البيانات كسلاسل في أزواج المفتاح/القيمة. يتم تلقائيًا تحويل أنواع البيانات التي ليست سلاسل حاليًا إلى سلاسل، بما في ذلك الطرق المضمّنة في الكائنات المحفوظة.
حفظ البيانات
لحفظ قيمة واحدة، استدعِ الدالة Properties.setProperty(key,
value)
من المتجر المناسب، كما هو موضّح في المثال التالي:
لحفظ البيانات بشكل مجمّع، مرِّر خريطة لأزواج المفتاح/القيمة إلى Properties.setProperties(properties).
يتم تخزين كل زوج مفتاح/قيمة من العنصر في المَعلمة كسمة منفصلة:
قراءة البيانات
لاسترداد قيمة واحدة سبق أن حفظتها، استدعِ الدالة
Properties.getProperty:
لاسترداد جميع القيم في مخزن السمات الحالي، استخدِم
Properties.getProperties:
تعديل البيانات
يعرض الإجراءان getProperty وgetProperties نسخة من البيانات المخزّنة، وليس عرضًا مباشرًا، لذا لن يؤدي تغيير العنصر المعروض إلى تعديل القيمة في متجر المواقع. لتعديل البيانات في المتجر، احفظها مرة أخرى باتّباع الخطوات التالية:
حذف البيانات
لحذف قيمة واحدة، استخدِم الرمز
Properties.deleteProperty:
لحذف جميع السمات في المتجر الحالي، استخدِم الأمر
Properties.deleteAllProperties:
إدارة مواقع النص البرمجي يدويًا
يمكنك إضافة ما يصل إلى خمسين موقعًا مخصّصًا يدويًا، كسلاسل في أزواج المفتاح/القيمة، من صفحة إعدادات المشروع. لإضافة أكثر من خمسين سمة، يمكنك إضافتها آليًا باستخدام الطرق الموضّحة في القسم السابق ضمن حفظ البيانات. عند ضبط خصائص النص البرمجي من صفحة إعدادات المشروع، لا تشِر إلى متغيرات النص البرمجي.
إضافة خصائص النص البرمجي
- افتح مشروعك في "برمجة تطبيقات Google".
- على يمين الصفحة، انقر على إعدادات المشروع
.
- لإضافة الموقع الأول، انقر على إضافة خاصية للنص البرمجي ضمن خصائص النص البرمجي.
- لإضافة سمات ثانية ولاحقة، انقر على تعديل سمات النص البرمجي > إضافة سمة للنص البرمجي ضمن سمات النص البرمجي.
- بالنسبة إلى السمة، أدخِل اسم المفتاح.
- في حقل القيمة، أدخِل قيمة المفتاح.
- (اختياري) لإضافة المزيد من الخصائص، انقر على إضافة خاصية للنص البرمجي.
- انقر على حفظ مواقع النص البرمجي.
تعديل مواقع النص البرمجي
- افتح مشروعك في "برمجة تطبيقات Google".
- على يمين الصفحة، انقر على إعدادات المشروع
.
- ضمن خصائص النص البرمجي، انقر على تعديل خصائص النص البرمجي.
- أجرِ تغييرات على اسم المفتاح وقيمته لكل موقع تريد تغييره.
- انقر على حفظ مواقع النص البرمجي.
حذف مواقع النص البرمجي
- افتح مشروعك في "برمجة تطبيقات Google".
- على يمين الصفحة، انقر على إعدادات المشروع
.
- ضمن خصائص النص البرمجي، انقر على تعديل خصائص النص البرمجي.
- بجانب الموقع الذي تريد حذفه، انقر على إزالة .
- انقر على حفظ مواقع النص البرمجي.