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