Class UserProperties

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)