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 Сохраняет указанное значение с предоставленным ключом.

Устаревшие методы

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Удаляет все свойства. 

ScriptProperties.deleteAllProperties();

Возвращаться

ScriptProperties — этот объект для цепочки

См. также

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Удаляет свойство с заданным ключом. 

ScriptProperties.deleteProperty('special');

Параметры

Имя Тип Описание
key String ключ для свойства, которое нужно удалить

Возвращаться

ScriptProperties — этот объект для цепочки

См. также

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Получите все доступные ключи.

Возвращаться

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, если такого значения нет. 

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

Параметры

Имя Тип Описание
key String ключ для значения, которое нужно получить

Возвращаться

String — значение, связанное с ключом

См. также

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Массовая установка всех свойств, извлеченных из данного объекта. 

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

Параметры

Имя Тип Описание
properties Object объект, содержащий свойства, которые необходимо установить.

Возвращаться

ScriptProperties — этот объект для цепочки

См. также

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Массовая установка всех свойств, извлеченных из данного объекта. 

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

Параметры

Имя Тип Описание
properties Object объект, содержащий свойства, которые необходимо установить.
deleteAllOthers Boolean следует ли удалять все существующие свойства.

Возвращаться

ScriptProperties — этот объект для цепочки

См. также

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Сохраняет указанное значение с помощью предоставленного ключа. Любое существующее значение, связанное с этим ключом, будет перезаписано. 

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

Параметры

Имя Тип Описание
key String ключ от собственности
value String значение, которое можно связать с ключом

Возвращаться

ScriptProperties — этот объект для цепочки

См. также