تتيح لك خدمة المواقع تخزين بيانات بسيطة في أزواج المفتاح/القيمة تم تحديدها إلى نص برمجي واحد أو مستخدم واحد للنص البرمجي مستند واحد يتم استخدام إضافة فيه من المهم يُستخدم عادةً لتخزين إعدادات مطوّر البرامج أو الإعدادات المفضّلة للمستخدم. أماكن إقامة لا تتم مشاركتها أبدًا بين النصوص البرمجية.
لعرض الحصص اليومية وحدود مساحة التخزين لخدمة "المواقع"، يُرجى الاطّلاع على حصص خدمات 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".
- على يمين الصفحة، انقر على رمز إعدادات المشروع .
- ضمن خصائص النص البرمجي، انقر على تعديل مواقع النص البرمجي.
- بجانب الموقع الذي تريد حذفه، انقر على "إزالة ".
- انقر على حفظ مواقع النص البرمجي.