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