Class Properties

سيؤدي ذلك إلى حذف جميع المواقع في متجر Properties الحالي.

// Deletes all user properties.
var userProperties = PropertiesService.getUserProperties();
userProperties.deleteAllProperties();

استرجاع الكرة

Properties - هذا المتجر من Properties، للسلاسل

يؤدي هذا الإجراء إلى حذف الموقع الذي يتضمّن المفتاح المحدّد في متجر "Properties" الحالي.

// Deletes the user property 'nickname'.
var userProperties = PropertiesService.getUserProperties();
userProperties.deleteProperty('nickname');

المَعلمات

استرجاع الكرة

Properties - هذا المتجر من Properties، للسلاسل

يمكن الحصول على جميع المفاتيح في متجر "Properties" الحالي.

// Sets several properties, then logs the value of each key.
var scriptProperties = PropertiesService.getScriptProperties();
scriptProperties.setProperties({
  'cow': 'moo',
  'sheep': 'baa',
  'chicken': 'cluck'
});
var keys = scriptProperties.getKeys();
Logger.log('Animals known:');
for (var i = 0; i < keys.length; i++) {
  Logger.log(keys[i]);
}

استرجاع الكرة

String[] - مجموعة من جميع المفاتيح في متجر Properties الحالي

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

// Sets several script properties, then retrieves them and logs them.
var scriptProperties = PropertiesService.getScriptProperties();
scriptProperties.setProperties({
  'cow': 'moo',
  'sheep': 'baa',
  'chicken': 'cluck'
});

var animalSounds = scriptProperties.getProperties();

// Logs:
// A chicken goes cluck!
// A cow goes moo!
// A sheep goes baa!
for (var kind in animalSounds) {
  Logger.log('A %s goes %s!', kind, animalSounds[kind]);
}

استرجاع الكرة

Object - نسخة من كل أزواج المفتاح/القيمة في متجر Properties الحالي

الحصول على القيمة المرتبطة بالمفتاح المحدّد في متجر Properties الحالي أو القيمة null في حال عدم توفّر هذا المفتاح

// Gets the user property 'nickname'.
var userProperties = PropertiesService.getUserProperties();
var nickname = userProperties.getProperty('nickname');
Logger.log(nickname);

المَعلمات

استرجاع الكرة

String: القيمة المرتبطة بالمفتاح المحدّد في متجر Properties الحالي

تحدِّد هذه السياسة كل أزواج المفتاح/القيمة من العنصر المحدّد في متجر Properties الحالي.

// Sets multiple user properties at once.
var userProperties = PropertiesService.getUserProperties();
var newProperties = {nickname: 'Bob', region: 'US', language: 'EN'};
userProperties.setProperties(newProperties);

المَعلمات

استرجاع الكرة

Properties - هذا المتجر من Properties، للسلاسل

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

// Sets multiple user properties at once while deleting all other user properties.
var userProperties = PropertiesService.getUserProperties();
var newProperties = {nickname: 'Bob', region: 'US', language: 'EN'};
userProperties.setProperties(newProperties, true);

المَعلمات

استرجاع الكرة

Properties - هذا المتجر من Properties، للسلاسل

لضبط زوج المفتاح/القيمة المحدّد في متجر Properties الحالي.

// Sets the user property 'nickname' to 'Bobby'.
var userProperties = PropertiesService.getUserProperties();
userProperties.setProperty('nickname', 'Bobby');

المَعلمات

استرجاع الكرة

Properties - هذا المتجر من Properties، للسلاسل