Class ScriptProperties

脚本属性

已弃用。此类已废弃,不应在新脚本中使用。

脚本属性是脚本在永久存储区中存储的键值对。脚本属性的范围是按脚本划分的,无论是哪位用户运行脚本,都是如此。

方法返回类型简介
deleteAllProperties()ScriptProperties删除所有媒体资源。
deleteProperty(key)ScriptProperties删除具有给定键的媒体资源。
getKeys()String[]获取所有可用按键。
getProperties()Object一次性获取所有可用媒体资源。
getProperty(key)String返回与所提供键关联的值;如果没有此类值,则返回 null。
setProperties(properties)ScriptProperties批量设置从给定对象中提取的所有属性。
setProperties(properties, deleteAllOthers)ScriptProperties批量设置从给定对象中提取的所有属性。
setProperty(key, value)ScriptProperties使用提供的键保留指定的 in 值。

已弃用的方法

已弃用。此函数已废弃,不应在新脚本中使用。

删除所有媒体资源。

ScriptProperties.deleteAllProperties();

返回

ScriptProperties - this 对象,用于链式调用

另请参阅


已弃用。此函数已废弃,不应在新脚本中使用。

删除具有给定键的媒体资源。

ScriptProperties.deleteProperty('special');

参数

名称类型说明
keyString要删除的媒体资源的键

返回

ScriptProperties - this 对象,用于链式调用

另请参阅


已弃用。此函数已废弃,不应在新脚本中使用。

获取所有可用按键。

返回

String[]


已弃用。此函数已废弃,不应在新脚本中使用。

一次性获取所有可用媒体资源。

这会返回一个副本,而不是实时视图,因此更改返回对象的属性不会更新存储空间中的属性,反之亦然。

ScriptProperties.setProperties({
  "cow"     : "moo",
  "sheep"   : "baa",
  "chicken" : "cluck"
});

// Logs "A cow goes: moo"
Logger.log("A cow goes: %s", ScriptProperties.getProperty("cow"));

// This makes a copy. Any changes that happen here will not
// be written back to properties.
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 - 包含键值对的属性的副本


已弃用。此函数已废弃,不应在新脚本中使用。

返回与所提供键关联的值;如果没有此类值,则返回 null。

const specialValue = ScriptProperties.getProperty('special');

参数

名称类型说明
keyString要检索的值的键

返回

String - 与键关联的值

另请参阅


已弃用。此函数已废弃,不应在新脚本中使用。

批量设置从给定对象中提取的所有属性。

ScriptProperties.setProperties({special: 'sauce', 'meaning': 42});

参数

名称类型说明
propertiesObject包含要设置的属性的对象。

返回

ScriptProperties - this 对象,用于链式调用

另请参阅


已弃用。此函数已废弃,不应在新脚本中使用。

批量设置从给定对象中提取的所有属性。

// This deletes all other properties
ScriptProperties.setProperties({special: 'sauce', 'meaning': 42}, true);

参数

名称类型说明
propertiesObject包含要设置的属性的对象。
deleteAllOthersBoolean是否删除所有现有媒体资源。

返回

ScriptProperties - this 对象,用于链式调用

另请参阅


已弃用。此函数已废弃,不应在新脚本中使用。

使用提供的键保留指定的 in 值。与此键关联的任何现有值都将被覆盖。

ScriptProperties.setProperty('special', 'sauce');

参数

名称类型说明
keyString媒体资源的键
valueString要与键关联的值

返回

ScriptProperties - this 对象,用于链式调用

另请参阅