Эта страница переведена с помощью Cloud Translation API.

Class UserProperties

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

Свойства пользователя — это пары ключ-значение, уникальные для пользователя. Свойства пользователя ограничены для каждого пользователя; любой сценарий, запущенный под именем пользователя, может получить доступ к свойствам пользователя только для этого пользователя.

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

Метод	Тип возврата	Краткое описание
`deleteAllProperties()`	`UserProperties`	Удаляет все свойства.
`deleteProperty(key)`	`UserProperties`	Удаляет свойство с заданным ключом.
`getKeys()`	`String[]`	Получите все доступные ключи.
`getProperties()`	`Object`	Получите все доступные свойства одновременно.
`getProperty(key)`	`String`	Возвращает значение, связанное с предоставленным ключом, или значение NULL, если такого значения нет.
`setProperties(properties)`	`UserProperties`	Массовая установка всех свойств, извлеченных из данного объекта.
`setProperties(properties, deleteAllOthers)`	`UserProperties`	Массовая установка всех свойств, извлеченных из данного объекта.
`setProperty(key, value)`	`UserProperties`	Сохраняет указанное значение с помощью предоставленного ключа.

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

`deleteAllProperties()`

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

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

UserProperties.deleteAllProperties();

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

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

Смотрите также

deleteProperty(key)

`deleteProperty(key)`

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

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

UserProperties.deleteProperty('special');

Параметры

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

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

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

Смотрите также

deleteAllProperties()

`getKeys()`

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

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

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

String[]

`getProperties()`

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

Получите все доступные свойства одновременно.

Это дает копию, а не просмотр в реальном времени, поэтому изменение свойств возвращаемого объекта не приведет к их обновлению в хранилище, и наоборот.

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

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

// This makes a copy. Any changes that happen here will not
// be written back to properties.
var animalSounds = UserProperties.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 — копия свойств, содержащая пары ключ-значение.

`getProperty(key)`

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

Возвращает значение, связанное с предоставленным ключом, или значение NULL, если такого значения нет.

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

Параметры

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

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

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

Смотрите также

setProperty(key, value)

`setProperties(properties)`

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

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

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

Параметры

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

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

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

Смотрите также

setProperty(key, value)

`setProperties(properties, deleteAllOthers)`

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

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

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

Параметры

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

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

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

Смотрите также

setProperty(key, value)

`setProperty(key, value)`

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

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

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

Параметры

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

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

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

Смотрите также

getProperty(key)