Properties Service

属性

此服务允许脚本将字符串存储为一个脚本范围、一个脚本用户或一个使用编辑器插件的文档。如需详细了解何时使用每种类型的属性,请参阅属性服务指南

名称简介
Properties属性对象充当访问用户、文档或脚本属性的接口。
PropertiesService允许脚本将简单数据存储到一个脚本、一个脚本的用户或一个使用插件的文档中。
ScriptProperties脚本属性是由脚本在持久性存储区中存储的键值对。
UserProperties用户属性是用户独有的键值对。

Properties

方法

方法返回类型简介
deleteAllProperties()Properties删除当前 Properties 存储区中的所有属性。
deleteProperty(key)Properties删除当前 Properties 存储区中具有给定键的属性。
getKeys()String[]获取当前 Properties 存储区中的所有密钥。
getProperties()Object获取当前 Properties 存储区中所有键值对的副本。
getProperty(key)String获取与当前 Properties 存储区中给定键关联的值,如果不存在此类键,则获取 null
setProperties(properties)Properties设置当前 Properties 存储区中给定对象的所有键值对。
setProperties(properties, deleteAllOthers)Properties设置当前 Properties 存储区中给定对象的所有键值对,还可选择删除存储区中的所有其他属性。
setProperty(key, value)Properties设置当前 Properties 存储区中给定的键值对。

PropertiesService

方法

方法返回类型简介
getDocumentProperties()Properties获取所有用户均可在打开的文档、电子表格或表单中访问的属性存储区(仅限此脚本)。
getScriptProperties()Properties获取所有用户均可访问的属性存储区,但仅限于此脚本。
getUserProperties()Properties获取只有当前用户可以访问且仅在此脚本内访问的属性存储区。

ScriptProperties

UserProperties