خدمة العقارات

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

تتيح لك خدمة الخصائص تخزين البيانات البسيطة في أزواج المفتاح/القيمة المحدّدة لنص برمجي واحد أو مستخدم واحد للنص البرمجي أو مستند واحد يتم فيه استخدام إضافة. ويُستخدم عادةً في تخزين إعدادات مطوّر البرامج أو الإعدادات المفضّلة للمستخدم. لا تتم مشاركة المواقع بين النصوص البرمجية مطلقًا.

لعرض الحصص اليومية وحدود مساحة التخزين لخدمة "مواقع Google"، راجِع حصص خدمات Google.

مقارنة متاجر العقارات

يقدّم الكائن العام PropertiesService ثلاث طرق، تعرض كل منها كائنًا مشابهًا Properties ولكن لها حقوق وصول مختلفة، كما هو موضّح في الجدول التالي:

خصائص النص البرمجي خصائص المستخدم خصائص المستند
طريقة الوصول getScriptProperties() getUserProperties() getDocumentProperties()
البيانات المشترَكة بين جميع مستخدمي نص برمجي أو إضافة أو تطبيق ويب المستخدم الحالي للنص البرمجي أو الإضافة أو تطبيق الويب كل مستخدمي الإضافة في المستند المفتوح
شائع الاستخدام مع بيانات الإعداد على مستوى التطبيق، مثل اسم المستخدم وكلمة المرور لقاعدة البيانات الخارجية لمطوّر البرامج الإعدادات الخاصة بالمستخدم، مثل المقياس أو الوحدات الإمبراطورية بيانات خاصة بالمستندات، مثل عنوان URL للرسم البياني المُضمَّن

تنسيق البيانات

تخزّن خدمة المواقع جميع البيانات كسلاسل في أزواج المفتاح/القيمة. يتم تحويل أنواع البيانات التي ليست سلاسل من قبل إلى سلاسل تلقائيًا، بما في ذلك الطرق المضمّنة في العناصر المحفوظة.

جارٍ حفظ البيانات

لحفظ قيمة واحدة، يمكنك استدعاء الطريقة Properties.setProperty(key, value) للمتجر المناسب، كما هو موضّح في المثال التالي:

service/propertyService.gs
try {
  // Set a property in each of the three property stores.
  const scriptProperties = PropertiesService.getScriptProperties();
  const userProperties = PropertiesService.getUserProperties();
  const documentProperties = PropertiesService.getDocumentProperties();

  scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/');
  userProperties.setProperty('DISPLAY_UNITS', 'metric');
  documentProperties.setProperty('SOURCE_DATA_ID',
      '1j3GgabZvXUF177W0Zs_2v--H6SPCQb4pmZ6HsTZYT5k');
} catch (err) {
  // TODO (developer) - Handle exception
  Logger.log('Failed with error %s', err.message);
}

لحفظ البيانات بشكل مجمّع، مرِر خريطة أزواج المفتاح/القيمة إلى Properties.setProperties(properties). يتم تخزين كل زوج مؤلف من مفتاح وقيمة للعنصر في المعلمة كخاصية منفصلة:

service/propertyService.gs
try {
  // Set multiple script properties in one call.
  const scriptProperties = PropertiesService.getScriptProperties();
  scriptProperties.setProperties({
    'cow': 'moo',
    'sheep': 'baa',
    'chicken': 'cluck'
  });
} catch (err) {
  // TODO (developer) - Handle exception
  Logger.log('Failed with error %s', err.message);
}

قراءة البيانات

لاسترداد قيمة واحدة سبق لك حفظها، يمكنك الاتصال بالرقم Properties.getProperty(key):

service/propertyService.gs
try {
  // Get the value for the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  const units = userProperties.getProperty('DISPLAY_UNITS');
  Logger.log('values of units %s', units);
} catch (err) {
  // TODO (developer) - Handle exception
  Logger.log('Failed with error %s', err.message);
}

لاسترداد كل القيم في مخزن الموقع الحالي، اطلب Properties.getProperties():

service/propertyService.gs
try {
  // Get multiple script properties in one call, then log them all.
  const scriptProperties = PropertiesService.getScriptProperties();
  const data = scriptProperties.getProperties();
  for (const key in data) {
    Logger.log('Key: %s, Value: %s', key, data[key]);
  }
} catch (err) {
  // TODO (developer) - Handle exception
  Logger.log('Failed with error %s', err.message);
}

تعديل البيانات

تعرض الطريقتان getProperty() وgetProperties() نسخة من البيانات المخزّنة، وليس عرضًا مباشرًا، لذا لن يؤدي تغيير العنصر المعروض إلى تعديل القيمة في المتجر. لتعديل البيانات في المتجر، ما عليك سوى حفظها مجددًا:

service/propertyService.gs
try {
  // Change the unit type in the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  let units = userProperties.getProperty('DISPLAY_UNITS');
  units = 'imperial'; // Only changes local value, not stored value.
  userProperties.setProperty('DISPLAY_UNITS', units); // Updates stored value.
} catch (err) {
  // TODO (developer) - Handle exception
  Logger.log('Failed with error %s', err.message);
}

حذف البيانات

لحذف قيمة واحدة، اطلب Properties.deleteProperty(key):

service/propertyService.gs
try {
  // Delete the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  userProperties.deleteProperty('DISPLAY_UNITS');
} catch (err) {
  // TODO (developer) - Handle exception
  Logger.log('Failed with error %s', err.message);
}

لحذف جميع المواقع الإلكترونية في المتجر الحالي، يمكنك الاتصال Properties.deleteAllProperties():

service/propertyService.gs
try {
  // Get user properties in the current script.
  const userProperties = PropertiesService.getUserProperties();
  // Delete all user properties in the current script.
  userProperties.deleteAllProperties();
} catch (err) {
  // TODO (developer) - Handle exception
  Logger.log('Failed with error %s', err.message);
}

إدارة مواقع النص البرمجي يدويًا

يمكنك إضافة ما يصل إلى خمسين موقعًا مخصّصًا يدويًا، كسلاسل في أزواج المفتاح/القيمة، من صفحة إعدادات المشروع. لإضافة أكثر من خمسين موقعًا، يجب إضافتها آليًا باستخدام الطرق الموضّحة أعلاه في حفظ البيانات. عند إعداد مواقع النص البرمجي من صفحة إعدادات المشروع، لا يمكنك الإشارة إلى متغيّرات النص البرمجي.

إضافة مواقع النص البرمجي

  1. افتح مشروع "برمجة تطبيقات Google".
  2. على يمين الصفحة، انقر على إعدادات المشروع رمز إعدادات المشروع.
  3. لإضافة الموقع الإلكتروني الأول، ضمن سمات النص البرمجي، انقر على إضافة موقع نص برمجي.
  4. لإضافة مواقع ثانية وأخرى لاحقة، ضمن خصائص النص البرمجي، انقر على تعديل مواقع النص البرمجي > إضافة موقع نص برمجي.
  5. بالنسبة إلى الموقع، أدخِل اسم المفتاح.
  6. بالنسبة إلى القيمة، أدخِل قيمة المفتاح.
  7. (اختياري) لإضافة المزيد من المواقع، انقر على إضافة موقع نص برمجي.
  8. انقر على حفظ مواقع النص البرمجي.

تعديل مواقع النص البرمجي

  1. افتح مشروع "برمجة تطبيقات Google".
  2. على يمين الصفحة، انقر على إعدادات المشروع رمز إعدادات المشروع.
  3. ضمن مواقع النص البرمجي، انقر على تعديل مواقع النص البرمجي.
  4. أدخِل تغييرات على اسم المفتاح وقيمة المفتاح لكل موقع تريد تغييره.
  5. انقر على حفظ مواقع النص البرمجي.

حذف مواقع النص البرمجي

  1. افتح مشروع "برمجة تطبيقات Google".
  2. على يمين الصفحة، انقر على إعدادات المشروع رمز إعدادات المشروع.
  3. ضمن مواقع النص البرمجي، انقر على تعديل مواقع النص البرمجي.
  4. بجانب الموقع الإلكتروني الذي تريد حذفه، انقر على رمز الإزالة .
  5. انقر على حفظ مواقع النص البرمجي.